Page History

...

If the application server is running on an IBM AIX version 5.x computer, and you want to enable Precise for J2EE to report CPU numbers for each method invocation, set and export the AIXTHREAD_ENRUSG parameter as follows:

AIXTHREAD_ENRUSG=ON

export AIXTHREAD_ENRUSG

Anchor
ManuallyenablingPreciseforJ2EEmonitoring ManuallyenablingPreciseforJ2EEmonitoring

Manually enabling Precise for J2EE monitoring

...

• For Java 1.5
  • Add the following arguments to the Java command line of the JVM to be monitored:
    • For an instance
      

      -javaagent:<precise_root>\products\j2ee\lib\indepthj2ee-agent.jar=com. precise.javaperf.javaagent.agents.DefaultJavaAgent
-Dindepth.j2ee.server=<precise_root>\products\j2ee\config\<INSTANCE_NAME> -DisClustered=false

    • For a cluster
      -javaagent:<precise_root>\products\j2ee\lib\indepthj2ee-agent.jar=com. precise.javaperf.javaagent.agents.DefaultJavaAgent
-Dindepth.j2ee.server=<precise_root>\products\j2ee\config\<CLUSTER_NAME> -DisClustered=true

      Info
      Be sure to use the <JAVA_HOME> that the application server uses, not the <JAVA_HOME> located in the Precise product installation folder. The apladmin program will attempt to prevent any use of a JVM located under <precise_root>.

    • For Java 1.4
      1. Configure instrumentation by executing the following command from the <precise_root> folder, replacing <JAVA_HOME> with the path to the Java home of the application to be monitored:
         
         • Windows. products\j2ee\bin\apladmin modrt --jvm-id=<instance (jvm)_name/cluster_name> "<JAVA_HOME>\bin\java.exe"
           For example:
           products\j2ee\bin\apladmin modrt --jvm-id=<instance (jvm)_name/cluster_name> "c:\j2sdk1.4.2_08\bin\java.exe"

         • UNIX. products/j2ee/bin/apladmin.sh modrt --jvm-id=<instance (jvm)_name/cluster_name> "<JAVA_HOME>/bin/java"
           For example:
           products/j2ee/bin/apladmin.sh modrt --jvm-id=<instance (jvm)_name/cluster_name> "/opt/j2sdk1.4.2_08/bin/java"

           Info
           Be sure to use the <JAVA_HOME> that the application server uses, not the <JAVA_HOME> located in the Precise product installation folder. The apladmin program will attempt to prevent any use of a JVM located under <precise_root>.

      2. Follow the instructions in the command output to modify the Java command line of the JVM to be monitored.
      3. Add the -DisClustered=false flag to the arguments from apladmin. For a clustered installation, specify 'true' for this flag.
      4. After executing the apladmin.modrt, add the parameters to the JVM startup command line.
         For example:
         -Xbootclasspath/p:C:\Precise\products\j2ee\etc\apl\jvms\java-vm-TestApp\lib\rt.jar
-Xbootclasspath/p: C:\Precise\products\j2ee\lib\indepthj2eeboot.jar
-Xbootclasspath/p: C:\Precise\products\j2ee\classes
-Dindepth.j2ee.server= C:\Precise\products\j2ee\config\TestApp
-DisClustered=false

...

To manually execute the action items1.    Start

1. Start the cluster with Precise instrumentation by adding the following parameters to the Java command:
   -javaagent:

...

1. <precise_

...

1. root>\products\j2ee\lib\indepthj2ee-agent.jar=com.precise.javaperf.javaagent.agents.DefaultJavaAgent
-Dindepth.j2ee.server=

...

1. <precise_

...

1. root>\products\j2ee\config\

...

1. <cluster_

...

1. name>
-DisClustered=true

...

1. Repeat for each cluster started by the startup script.

Anchor
ManuallyexecutingWebSpherepostinstallationactionitemsininstanceandclusterapplications ManuallyexecutingWebSpherepostinstallationactionitemsininstanceandclusterapplications

Manually executing WebSphere post-installation action items in instance and cluster applications

...

To manually instrument a WebSphere instance/cluster1.    Configure

1. Configure instrumentation by executing the following command from the <precise_root> folder, replacing <JAVA_HOME> with the path to the Java home of the application to be monitored.

...

1. • Windows. products\j2ee\bin\apladmin modrt --jvm-id=

...

1. • <instance (jvm)_name/cluster_

...

1. • name> "

...

1. • <JAVA_

...

1. • HOME>\bin\java.exe"

...

1. • UNIX. ./products/j2ee/bin/apladmin.sh modrt --jvm-id=

...

1. • <instance (jvm)_name/cluster_

...

1. • name> "

...

1. • <JAVA_

...

1. • HOME>\bin\java.exe"

     Info

...

1. • Be sure to use the

...

1. • <JAVA_

...

1. • HOME> that the application server uses, not the

...

1. • <JAVA_

...

1. • HOME> located in the Precise product installation folder.

...

1. Follow the apladmin instructions.

...

1. Add the -DisClustered=false flag to the arguments from apladmin. For a cluster, specify 'true' for this flag.

...

1. To enable RMI transaction monitoring, add the following text:
   Dorg.omg.PortableInterceptor.ORBInitializerClass.com.precise.javaperf.lib.smartlink.PreciseSmartlinkORBInitializer For example, the user will add the following arguments to WAS java arguments:
   -Xbootclasspath/p:C:\Precise\products\j2ee\etc\apl\jvms\java-vm-TestApp\lib\rt.jar
-Xbootclasspath/p: C:\Precise\products\j2ee\lib\indepthj2eeboot.jar
-Xbootclasspath/p: C:\Precise\products\j2ee\classes
-Dindepth.j2ee.server= C:\Precise\products\j2ee\config\TestApp
-DisClustered=false

...

1. Info
   Generally the <JAVA_HOME> for WebSphere installations can be found in the Application

...

1. > WebSphere variables section in the WebSphere Administrative Console.

...

1. Enable Application Server Metrics by performing the following steps:

   ...

   1. 1. Verify that the Performance Monitoring Service is enabled by marking the "Enable Performance Monitoring Infrastructure (PMI)" setting located on the Application Servers >

   ...

   1. 1. <SERVER_

   ...

   1. 1. NAME> > Performance Monitoring Infrastructure (PMI) page.

   ...

   1. 1. Verify that the initial specification level is "Basic" or "Custom."

   ...

   ...

   1. 1. After Performance Monitoring Service is confirmed to be enabled at startup, perform the following steps to configure the Application Server Metrics collection:

      ...

      1. 1. 1. Select Servers > Application Servers >

      ...

      1. 1. 1. <SERVER_

      ...

      1. 1. 1. NAME> > Server Infrastructure > Administration > Custom Services.

      ...

      1. 1. 1. Click New.

      ...

      1. 1. 1. Mark the "Enable service at service startup" check box.

      ...

      1. 1. 1. Leave the External Configuration URL blank.

      ...

      1. 1. 1. Set the "Classname" to com.precise.javaperf.extensions.websphere.PreciseMetricPluginLoader

      ...

      1. 1. 1. Set the "Display Name" to PreciseMetricPluginLoader

      ...

      1. 1. 1. Set the "Classpath" to:

      ...

      1. 1. 1. <precise_

      ...

      1. 1. 1. root>/products/j2ee/lib/indepthmetric.jar

      ...

      1. 1. 1. Save the changes.

      ...

      1. Update the security policy.

         ...

         1. 1. Edit the <WAS_INSTALL_

         ...

         1. 1. ROOT>/profiles/<SERVER>/properties/server.policy file to include the following:
               grant codeBase "file:

         ...

         1. 1. <precise_

         ...

         1. 1. root>/-" {
permission java.security.AllPermission;
};

               Info

         ...

         1. 1. In Windows, change the PATH separator from '\' to the UNIX style separator '/'.

         ...

         1. Restart the Application server.

         ...

         1. Info
            For clustered applications, the user must verify that the rt.jar generated in step 1, and pointed to by the Xbootclasspath, is located in all the servers that are running as part of the WebSphere cluster. The user can copy the rt.jar to any central location, and update the Xbootclasspath accordingly.

          

         Precise. Performance intelligence from click to storage. Learn more > >

         Precise Website	Solutions	Support	Support Portal	Community	About Us	Legal