Instrumenting servers by using the command prompt
Before you begin
The data collection infrastructure must be installed on each computer from which you want to collect performance data. The application server must be running. You must have administrator or root user privileges to instrument servers.
Procedure
- Open a command prompt, and go to the instrument_comp folder in the directory where the data collection infrastructure is installed. By default, in Microsoft Windows, this directory is C:\Program Files\IBM\SDP\DCI\rapa_prod\instrument_comp. In Linux and IBM® AIX®, this directory is /opt/IBM/SDP/DCI/rapa_prod/instrument_comp.
- Type the command name with the arguments to use to instrument a server. See the examples that follow. The instrumentation utility is instrumentServer.sh on AIX and Linux systems and instrumentServer.bat on Windows systems. Enter the command name with no arguments to see the syntax details for the command.
- After you have instrumented the application server, you might have to restart the application server. Instrumentation changes take effect after the application server is restarted.
Example
- IBM WebSphere® Application Server, Version 7.0.
- The server is named my_Server2.
- The application server is installed in the C:\Program Files\was7.0 directory.
- The profile name is default.
- Security is enabled.
- The server Java™ Virtual Machine (JVM) is a 64-bit JVM.
instrumentServer -install -type was7 -serverName my_Server2 -serverHome "C:\Program Files\was7.0" -serverVMArch 64 -user my_WAS_userId -password my_WAS_password -profileName default
To instrument a Linux computer that is equipped with a BEA WebLogic 10 application server, with configuration details as indicated, using the 32-bit version of JRockit JVM, type the following command and arguments:
./instrumentServer.sh -install -type wls10 -serverName server1 -serverHome /opt/bea/weblogic10 -serverVM oracle -serverVMArch 32 -startScript /opt/bea/weblogic10/mydomain/startWebLogic.sh
To instrument a Liberty Profile, for -type use liberty85, and for -serverHome use the path to the Liberty server installation directory until wlp.
What to do next
Repeat the instrumentation steps for each application server that is involved in data collection for the applications that you will profile. Typically, there will be only one application server. You can instrument only one local application server per computer.