IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1
Pre-configuration steps for J2SE users - J2EE Agent
If there is a startup script for your application server, edit the customized script before running the Configuration Tool. Specify the following two anchors in the customized script to correctly locate the appropriate section of the script and insert the configuration of the data collector into the startup script:
In the startup script start a new line to define the ITCAM_DC_SCRIPT anchor as follows before the execution of Java command:
- operating systems such as AIX or Linux: ### ITCAM_DC_SCRIPT
- Windows systems: REM ITCAM_DC_SCRIPT
The configuration of the data collector is inserted after this anchor when the Configuration Tool runs.
Add the ITCAM_JVM_OPTS anchor as the last JVM option in the customized script. Find where the JVM options is and insert ${ITCAM_JVM_OPTS} (on operating systems such as AIX or Linux) or %ITCAM_JVM_OPTS% (on Windows). Specify the ITCAM_JVM_OPTS anchor as the last JVM option, before the main class %MAINCLASS% in the J2SE JVM startup options.
Any existing Garbage Collection (GC) logging argument or Java security policy will be overwritten after the configuration process.
Examples:
%_EXECJAVA% %JAVA_OPTS% %CATALINA_OPTS% %DEBUG_OPTS% -Djava.endorsed.dirs="%JAVA_ENDORSED_DIRS%" -classpath "%CLASSPATH%" -Dcatalina.base="%CATALINA_BASE%" -Dcatalina.home="%CATALINA_HOME%" -Djava.io.tmpdir="%CATALINA_TMPDIR%" %ITCAM_JVM_OPTS% %MAINCLASS%\ %CMD_LINE_ARGS% %ACTION%
Parent topic:
Configure the ITCAM for J2EE data collector