IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1

Step 9: Enter Tomcat application instance information - J2EE Agent

You are prompted for information regarding the Tomcat Server instance to be configured for data collection.

In the Instance Names field, enter the name of the Tomcat Server instance that you wish to configure for data collection.

Use only English characters and Arabic numbers for instance names.

If you are configuring a new Tomcat server instance or editing an existing instance, ensure that each instance name is unique. The instance name information can be found in the directory, <DC_HOME>/runtime/. If there is an existing Tomcat Server instance name, you can find a child directory under this directory. The child directory takes the form as <Server Name>.<Node Name>.<Instance Name>. For example, tomcat_55_1029_1 is the instance name in the <DC_HOME>/runtime/tomcat55.tiv147.cn.ibm.com.tomcat_55_1029_1 directory.

In the Tomcat Server Startup Script field, browse to select the folder in which Tomcat is installed. In Windows, select bin > catalina.bat or in Unix, select bin > catalina.sh. The startup script contains the command lines to launch the application server.

If you wish to use a java service wrapper, select Use Java Service Wrapper. The Tomcat Server Startup Script field is replaced with two new fields, -Java Service Wrapper Startup File and Java Service Wrapper Configuration File.

In the Java Service Wrapper Startup File field, enter the full path of the java service wrapper startup file, e.g. c:/tomcat5.5/bin/wrapper.exe.

To support cascading configuration files in the java service wrapper framework, the base directory of the java service wrapper needs to be specified. This enables a user to define a relative path for an included configuration file. By default, the base-directory is the location of the wrapper.exe in Windows, or the script used to launch the wrapper in Unix. If the wrapper.working.dir property is defined in the java service wrapper configuration file, ITCAM will use the value of the property as the base directory.

In the Java Service Wrapper Configuration File field, enter the full path of the java service wrapper configuration file, e.g. c:/tomcat5.5/conf/wrapper.conf.

The java service wrapper configuration file is similar to the java properties file. It contains the information necessary to launch a JVM instance with the correct command line required by an application. The default file is wrapper.conf. When you configure Tomcat to use the java service wrapper, ITCAM creates a new file called itcam_wrapper.conf in the same directory as wrapper.conf. This file includes all ITCAM configuration items and is referenced as an include in wrapper.conf.

Click Next to proceed.


Parent topic:

Configure the J2EE data collector for Tomcat