IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1

Pre-configuration steps for ITCAM for J2EE data collector - J2EE Agent

The Configuration Tool supports a list of optional parameters to provide more customization when data collector is configured, such as specifying data collector log file location, additional JVM options and CLASSPATH. The parameters can be specified by creating a file named as optional_config_params.properties under the directory <DC_home>/installer/config_dc/. The Configuration Tool will read the content of the file and configure the data collector according to the value specified. The following table summarizes the parameters supported by the Configuration Tool:

This is an optional step. Default value will be used unless it is specified in optional_config_params.properties


Parameters supported by the Configuration Tool

Parameter Name Description
CCLOG_COMMON_DIR User-defined global logging common directory for the data collector, If the parameter is set, it will overwrite the default logging common directory.

Default logging common directory on Windows: C:\ibm\tivoli\common

Default logging common directory on UNIX: /var/ibm/tivoli/common

If the value of this parameter contains any shell variable or environment variable, for example, $MY_LOG_DIR (UNIX) or %MY_LOG_DIR% (Windows). The parameter EXTRA_APPEND_LOGOPTS is required to be true.

NEED_ITCAM_SPECIFY_GCLOG Possible values: true or false. Default value is true.

If you have a default GC log file configured in the JVM startup script (by means of the -Xloggc option) prior to the DC configuration, set this parameter to "true" and the Configuration Tool will send the GC log information to a new log file. From this moment on, the GC data will be written to the new file but the old default log will not be overwritten. The new GC log file will have the following path and name format:

<DC_HOME>/<ServerType><ServerVersion>-gc-log.log.<InstanceName>

You can choose not to add a new log file during the DC configuration and continue using the old log file. To do that set the NEED_ITCAM_SPECIFY_GCLOG parameter to "false" before running the Configuration Tool.

NEED_ITCAM_SECURITY_POLICY Possible values: true or false. Default value is false.

This parameter specifies whether the Configuration Tool should specify any Java security policy.

If the value is set to true, the Configuration Tool will add the option "-Djava.security.policy=<DC_HOME>/runtime/<InstanceDir>/<NodeName>.<InstanceName>.datacollector.policy" to the JVM startup options.

If the value is set to false, only the Java security policy file is created but no JVM startup option will be added

EXTRA_JVM_OPTION Additional JVM startup options to be added. If specified, the value will be appended to the JVM startup options.
EXTRA_CLASSPATH Additional CLASSPATH to be added. Multiple entries should be separated by colon (UNIX) or semicolon (Windows).
EXTRA_APPEND_LOGOPTS Possible values: true or false. Default is false.

This parameter specifies whether the Configuration Tool should append the log related Java system properties to the JVM startup options, instead of saving them in the dc.properties file.

The JVM system properties affected by this parameter include:

  • CCLOG_COMMON_DIR

  • jlog.qualDir

  • jlog.propertyFile

  • jlog.propertyFileDir.CYN

  • com.ibm.tivoli.itcam.toolkit.util.logging.qualDir

  • ibm.common.log.dir

  • jlog.common.dir

If the value is set to true, the log related Java system properties are appended to the JVM startup options.

If the value is set to false, the log related Java system properties are saved in the file <DC_HOME>/runtime/<InstanceDir>/dc.properties.

EXTRA_IGNORE_UNIX_PERMISSION Possible values: true or false. Default is false.DC

This parameter specifies whether the Configuration Tool should ignore non-root permission check.

This option is supported only in UNIX platform


Parent topic:

Configure the ITCAM for J2EE data collector