This section includes the following topics:
For instructions on remote monitoring of your J2EE instance, refer to the Installing Precise Components.
Before beginning the installation process, review the (JVM) instances you wish to monitor and choose the most applicable type of installation according to your needs.
J2EE instances can be installed in one of the three following ways:
This section describes the pre-installation tasks for the J2EE Collector.
Table 11-1 File system permissions
Folder | Permissions | Justification |
---|---|---|
<precise_root>/logs | Read/Write | Write log file, log file rotation |
<precise_root>/products/j2ee | Read/Write | Various configuration files, status files |
The Precise for J2EE Collectors uses network ports to communicate with the monitored JVMs. The default port that Precise for J2EE uses is: 20763.
This section describes the installation procedure for installing a single, independent J2EE Tier instance. For information on editing or removing an existing instance, see Editing or removing tier instances or clusters.
Before adding a Tier instance, create a list of all required inputs based on the screen information below. |
To add a Tier instance
Click OK.
To install an instance in an application, you must have ADMINISTRATE.INSTALL permission for the application in which you want to install the instance. If you only have permission for a specific technology, you will only be able to install in an application that is either empty, or is comprised of only the same technology. |
Click OK to open the J2EE Instance Installation - Property Settings dialog box. See Defining J2EE property settings.
Always refresh AdminPoint after adding an instance. |
To enter J2EE property settings
Click the drop-down menu to select the server where the JVM is running. If you want to add a new server, click Add. For more information, see see Adding a new server.
This is the name or IP address of the server where you want to install the J2EE Tier Collector. The server name appears in the list only if you previously defined it as a Precise Server. In upgrade mode, the list contains all servers that were installed or upgraded. Choose a server that was upgraded. |
Click the drop-down menu to select the application server type.
This is the type of the J2EE application server. Precise supports several J2EE application server types, including Oracle WebLogic, IBM WebSphere, Oracle AS, and Apache Tomcat. |
Click the drop-down menu to select the application server version.
The next two items are optional, but are required to enable automatic execution of post-installation action items. |
Mark the “WebLogic instance configured through admin console” check box.
For Precise to instrument the JVM, it must modify its startup configuration. A WebLogic instance is configured using either a local file on the instance machine, or settings configured in the WebLogic admin console. Select this option if installing a WebLogic instance that is configured through the WebLogic admin console. |
Enter the instance (JVM) name.
The instance name should be an alphanumeric string to be used by J2EE, Insight, Alerts, and Report Manager to identify the monitored application server instance. The instance name must be unique to the monitored host. |
The preview screen signifies that the AdminPoint Tier installer has gathered enough information to begin the installation phase.
The preview screen displays the following details before installation begins:
At this screen, you can still change any of the settings displayed. Click Back to change any of the displayed settings. Click Install to continue installation. Click Cancel to stop the installation process.
This screen appears when the AdminPoint Tier installer is actually performing the installation. Installation may take several minutes. The progress screen visually displays the progress of actual installation on selected servers.
This screen appears when the AdminPoint Tier Installer has completed installation of all Tier instances.
If there are no action items, click Finish (it will be the only option available) to complete the instance installation. If there are action items, click Next (it will be the only option available).
After a Tier instance is installed, you must perform post-installation tasks as may be required. Only after completing any post-installation tasks required can you start using the Tier instances you have just installed.
Perform any tasks displayed on this screen. For Precise to perform the action items, click Execute. If you have performed the action items yourself, click Mark as done.
This section describes the procedures that are needed to install a J2EE cluster. A J2EE cluster is defined as a set of JVMs that share the same instrumentation configuration and are started from a shared location. Installing a J2EE cluster has two parts. The first one, described below, consists of creating a repository for the cluster configuration based on the definition of any of the cluster's JVM and performing the action items on the shared location. Once the action items are performed and JVMs are restarted, the second part of the installation takes place and each JVM instance is installed automatically and Precise starts to monitor it.
When installing a J2EE cluster, verify that Precise is installed on all servers hosting JVMs that are part of the cluster. In the cluster script, the javaagent flag points to the Precise JAR file in each JVM installed as part of the cluster. If a server hosting a JVM that is part of the cluster does not have Precise installed, the JAR file will be missing, and all JVMs on that server will fail to start. |
For information on editing or removing an existing cluster, see Editing or removing tier instances or clusters.
Before adding a cluster, create a list of all required inputs based on the screen information below. |
To add a cluster
Click OK.
To install a cluster in an application, you must have explicit ADMINISTRATE.INSTALL permission for the application in which you want to install the cluster. If you only have permission for a specific technology, you will only be able to install in an application that is either empty, or is comprised of only the same technology. |
Click OK to open the J2EE Cluster Installation - Property Settings dialog box. See Defining J2EE cluster property settings.
Always refresh AdminPoint after adding a cluster. |
To enter J2EE property settings
Use a free-text identifier to provide a unique name to be shared by all instances in the cluster. In addition, a unique identifier will automatically be added to each instance.
For WebSphere and WebLogic, the unique name will be the application server name. For all other technologies, it will be a running number. |
Click the drop-down menu to select a server where any of the cluster’s JVMs are running. If you want to add a new server that is not listed, click Add. For more information, see About adding servers. You will have the chance to add more servers later on in the installation process.
This is the name or IP address of the server where you want to install the J2EE Tier Collector. The server name appears in the list only if you previously defined it as a Precise Server. |
Click the drop-down menu to select the application server type.
This is the type of the J2EE application server. Precise supports several J2EE application server types, including Oracle WebLogic, IBM WebSphere, Oracle AS, and Apache Tomcat. |
If installing Oracle WebLogic managed instances, mark the “Managed WebLogic Server” check box.
The last 2 items are optional, but are required to enable automatic execution of post-installation action items. |
The preview screen signifies that the AdminPoint cluster installer has gathered enough information to begin the installation phase.
The preview screen displays the following details before installation begins:
At this screen, you can still change any of the settings displayed. Click Back to change any of the displayed settings. Click Next to continue installation. Click Cancel to stop the installation process.
At this point, the cluster definitions are saved and an agent is only installed on the specified server. For servers that will be added after this point, the agent will be installed only once the JVM is started. |
This screen appears when the AdminPoint Cluster Installer is actually performing installation. Installation may take several minutes.
The progress screen visually displays the progress of actual installation on selected servers.
The Add Servers screen enables you to add more servers running the cluster's JVMs to the cluster. To add servers, first locate them in the left table or add them by pressing the Add button. To associate a server with the cluster, move it to the table on the right. This action will allow you to check the status of the installation of the JVMs on the selected servers. You can also add the servers to the right list at a later time by editing the cluster. See Editing or removing tier instances or clusters. Click Next to continue installation.
After a cluster is installed, you must perform post-installation tasks as required. Only after completing the post-installation tasks required can you start using the JVMs you have just installed.
Perform all tasks displayed on this screen. Click Copy All to copy the text of the action items to another location. Click Execute for Precise to perform the action items.
If you have two different clusters that are started by the same startup script, execute the action items manually by performing the procedure detailed in Manually executing post-installation action items when multiple clusters share a startup script. |
This screen appears when the AdminPoint Cluster Installer has completed installation of the cluster.
Click Finish (it will be the only option available) to complete the cluster installation. For cluster installation, every JVM that will start after all the action items have been applied, will automatically be installed and monitored in the Precise application.
After installing Precise agents for the J2EE Tier, post-installation action items must be executed. These action items vary according to the supported application, and can usually be executed automatically from the user interface. In some circumstances, however, these action items must be executed manually.
This section describes the automatic and manual post-installation action items for J2EE Tiers, and includes the following topics:
Most action items automatically appear as part of the installation process in the user interface.
To perform J2EE Tier post-installation tasks
This section describes the following manual procedures:
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
If the automatic execution of the post-installation action items failed, perform the following steps to enable monitoring for the installed instance or cluster:
Verify that the instance (JVM) or cluster name you enter is the same as the instance (JVM) or cluster name that you defined during installation. |
-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
Be sure to use the |
<precise_root>
folder, replacing <JAVA_HOME>
with the path to the Java home of the application to be monitored:products\j2ee\bin\apladmin modrt --jvm-id=<instance (jvm)_name/cluster_name> "<JAVA_HOME>\bin\java.exe"
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"
Be sure to use the |
-DisClustered=false
flag to the arguments from apladmin. For a clustered installation, specify 'true' for this flag.-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
If two different clusters are started by the same startup script, the automatic action items will not work properly. In this case, the user must edit the startup script manually and adjust it to the relevant cluster configuration.
To manually execute the action items
-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
By default, the user can automatically execute the post-installation action items for WebSphere application servers from the action items screen during installation. However, in some cases the automatic execution of the action items will not be possible or will fail. For example, if the WAS is secured, or the auto-detect phase failed (because the server was down, etc.), the automatic action items execution will fail. In such cases, the user will have to execute the action items manually.
To manually instrument a WebSphere instance/cluster
<precise_root>
folder, replacing <JAVA_HOME>
with the path to the Java home of the application to be monitored.products\j2ee\bin\apladmin modrt --jvm-id=<instance (jvm)_name/cluster_name> "<JAVA_HOME>\bin\java.exe"
UNIX. ./products/j2ee/bin/apladmin.sh modrt --jvm-id=<instance (jvm)_name/cluster_name> "<JAVA_HOME>\bin\java.exe"
Be sure to use the |
-DisClustered=false
flag to the arguments from apladmin. For a cluster, specify 'true' for this flag.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
Generally the |
<SERVER_NAME>
> Performance Monitoring Infrastructure (PMI) page.<SERVER_NAME>
> Server Infrastructure > Administration > Custom Services.com.precise.javaperf.extensions.websphere.PreciseMetricPluginLoader
PreciseMetricPluginLoader
<precise_root>/products/j2ee/lib/indepthmetric.jar
Edit the <WAS_INSTALL_ROOT>/profiles/<SERVER>/properties/server.policy
file to include the following:grant codeBase "file:<precise_root>/-" {
permission java.security.AllPermission;
};
In Windows, change the PATH separator from '\' to the UNIX style separator '/'. |
Restart the Application server.
For clustered applications, the user must verify that the |
| | | | | | | |