IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1

Pre-configuration steps for Tomcat users - J2EE Agent

When you installed the Tomcat server using the Windows installer, perform the following steps to pre-configure Tomcat DC manually. If you installed the Tomcat server using Tomcat archive build, skip the following steps.

In the following text, <TOMCAT_HOME> refers to the directory where Tomcat Application Server is installed. <DC_HOME> refers to the directory where TOMCAT DC is installed

For Tomcat 5.5, there is no batch script in <TOMCAT_HOME>\bin. Copy the batch scripts from archive build or other locations of Tomcat 5.5.

Before starting Tomcat windows service, navigate to My Computer > Advanced > Environment Variables and find the system variable PATH. Set it as <DC_HOME>\toolkit\lib\w32-ix86.

Configure Java CLASSPATH for Tomcat in Tomcat configuration tool by invoking tomcat5w.exe in <TOMCAT_HOME>\bin. Find Java Options in the tab page named Java and append the following command lines:

-Xbootclasspath/p:%DC_HOME%\toolkit\
lib\jiti.jar;%DC_HOME%\itcamdc\lib\ppe.probe-bootstrap.jar 
-Dam.appserver=%INSTANCE_NAME% 
-Dam.nodename=%NODE_NAME% 
-Djava.rmi.server.RMIClassLoaderSpi=com.ibm.tivoli.itcam.tomcat.sdc.DCRMIClass
LoaderSpi 
-Dappserver.platform=%TOMCAT_SERVER% 
-Dam.home=%DC_HOME%\itcamdc 
-Ditcam61.home=%DC_HOME% 
-Xrunam_%JDK_VENDOR%_%JDK_VERSION%:%DC_HOME%\runtime\%TOMCAT_SERVER%.%NODE_NAME%.
%INSTANCE_NAME%\jiti.properties 
-Djlog.propertyFileDir.CYN=%DC_HOME%\toolkit\etc 
-Djlog.propertyFile=cynlogging.properties 
-DArm40.ArmTransactionFactory=com.ibm.tivoli.itcam.toolkit.arm.j2.transaction.
Arm40TransactionFactory 
-Djlog.qualDir=%NODE_NAME%.%INSTANCE_NAME% 
-Dcom.ibm.tivoli.itcam.toolkit.util.logging.qualDir=%NODE_NAME%.%INSTANCE_NAME% 
-DITCAMfJ2=true 
-DArm4EventListener.0=com.ibm.tivoli.itcam.dc.event.ARM4TransactionDataHandler 
-Dcom.ibm.tivoli.transperf.instr.probes.impl.was.Globals.traceLevel=0 
-Dcom.ibm.tivoli.jiti.injector.IProbeInjectorManager=com.ibm.tivoli.itcam.toolkit.
ai.bcm.bootstrap.ProbeInjectorManager 
-Dorg.omg.PortableInterceptor.ORBInitializerClass.com.ibm.tivoli.itcam.dc.
orbinterpretor.Initializer 
-Dibm.common.log.dir=%LOG_PATH% 
-Djlog.common.dir=%LOG_PATH% 
-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager 
-Djava.util.logging.config.file=%TOMCAT_HOME%\conf\logging.properties 
-Djava.endorsed.dirs=%TOMCAT_HOME%\common\endorsed

  1. There should be no any space character at the end of each line.

  2. For Tomcat 5.0, the last three properties:
    -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager 
    -Djava.util.logging.config.file=%TOMCAT_HOME%\conf\logging.properties 
    -Djava.endorsed.dirs=%TOMCAT_HOME%\common\endorsed
    should be removed from Java Options.

In the above code, %DC_HOME% refers to the DC Installation home; %INSTANCE_NAME% refers to the instance name of Tomcat dc used to distinguish from others; %NODE_NAME% refers to host name of DC side server; %TOMCAT_SERVER% refers to the Tomcat version, which should be written as "tomcat50" or "tomcat55"; %JDK_VENDOR% refers to the JDK vendor, which should be either "sun" or "ibm"; %JDK_VERSION% refers to JDK version, which should be written as 15 when the JDK is 1.5; %TOMCAT_HOME% refers to the Tomcat installation home, and %LOG_PATH% refers to the Tomcat DC log file, whose default value should be "C:/PROGRA~1/IBM/tivoli/common". Replace the variables by their real value in your environment.


Parent topic:

Configure the ITCAM for J2EE data collector