Configuring Tomcat Data Collector

If Tomcat agent is running as a service, after configuring the agent on Windows, configure Tomcat Data Collector with the instructions given here.

About this task

After configuring and starting Tomcat agent instance, it generates or updates setenv.bat file in /CANDLEHOME/setenv_<instance_name>.bat. This file contains data collector configuration parameters necessary for configuration of Tomcat Data Collector.

Procedure

  1. Open Apache Tomcat Properties window, and click Java
  2. Open setenv_<instanceName>.bat from the location /CANDLEHOME/setenv_<instance_name>.bat
  3. Copy the value of JAVA_OPTS parameter from setenv_<instance_name>.bat shown in the block: 
    agentlib:am_ibm_16=C:\IBM\APM\otdchome\7.3.0.13.0\runtime\TOMTKWIN1 
-Xbootclasspath/p:C:\IBM\APM\otdchome\7.3.0.13.0\toolkit\lib\bcm-bootstrap.jar 
-Djava.security.policy=C:\IBM\APM\otdchome\7.3.0.13.0\itcamdc\etc\datacollector.policy 
-Dcom.ibm.tivoli.itcam.ai.runtimebuilder.inputs=
C:\IBM\APM\otdchome\7.3.0.13.0\runtime\TOMTKWIN1\TOM_TK_1_DCManual.txt 
-Dcom.ibm.tivoli.itcam.serverHome=C:\TOMCAT_9\apache-tomcat-9.0.5\apache-tomcat-9.0.5 
-Dam.home=C:\IBM\APM\otdchome\7.3.0.13.0\itcamdc 
-Dcom.ibm.tivoli.itcam.toolkit.runtime.dir=C:\IBM\APM\otdchome\7.3.0.13.0\runtime
  4. Paste this value into the text box labeled Java Options in the Java tab of Apache Tomcat Properties
  5. Click Apply
  6. Go to Control Panel, click System > Advanced > Environment Variables
  7. In System variables, edit the variable PATH by appending file path <OTDC_home>\toolkit\lib\win64;<OTDC_HOME>/ toolkit\lib\win64\ttapi and click OK
    Note: Replace <OTDC_home> with the real path of the toolkit installation directory. For instance, C:\IBM\APM\otdchome\7.3.0.13.0\toolkit\lib\win64;C:\IBM\APM\otdchome\7.3.0.13.0\toolkit\lib\win64\ttapi
  8. Click NEW to add a variable RUNTIME_DIR.
  9. Add Variable Name as RUNTIME_DIR and Variable Path as C:\IBM\APM\otdchome\7.3.0.13.0\runtime. This path is available in setenv_<instancename>.bat
  10. Restart Windows. Make sure that the Tomcat service startup is set to Automatic