You can use the Configuration utility in Silent mode to
perform all configuration tasks (including unconfiguration) for ITCAM Agent for J2EE. To do this, prepare the response file by modifying a sample provided
with the Agent.
All configuration tasks for the Agent can also be performed in
Silent mode, without user interaction. This may be especially useful
for large-scale deployments.
To perform a configuration task, you need to prepare a response
file, and then start the configuration utility.
Preparing a response file
To perform a configuration
task using silent mode, create a copy of a sample response file for
the task. Modify this copy, and save it in a work directory, for example,
as C:\TEMP\SILENT.
For each of the configuration
tasks for the agent, a sample response file is available in the
ITM_home\TMAITM6 directory (on Windows systems) or in the
ITM_home/samples directory (on Linux and UNIX systems). Make a copy of the file and edit
it as required, using the information provided in the comments within
the file.
- Configuring Monitoring Agent connection to the Monitoring Server
and Data Collector connection to the monitoring agent, while two
separate tasks in the GUI configuration (see Configure the monitoring agent connection to the monitoring server and Configure Monitoring Agent settings), are performed with one response file. If the Agent is to
communicate with the IBM Tivoli Monitoring infrastructure,
you must perform this configuration task before configuring the Data
Collector to monitor any application server instances. Do not perform
this task if Tivoli Monitoring
is not used (in a deep dive diagnostics only installation). The sample
file name is yjv_silent_config_agent.txt.
- Configuring the Data Collector to monitor an application server
instance: the sample file names for the different application
servers are:
- For J2SE, yjv_silent_config_j2sedc.txt
- For JBoss, yjv_silent_config_jbossdc.txt
- For NetWeaver, yjv_silent_config_netweaverdc.txt
- For Tomcat, yjv_silent_config_tomcatdc.txt
- For WebLogic, yjv_silent_config_wlsdc.txt
- Unconfiguring the Data Collector from an application server
instance: the sample file names for the different application
servers are:
- For J2SE, yjv_silent_unconfig_j2sedc.txt
- For JBoss, yjv_silent_unconfig_jbossdc.txt
- For NetWeaver, yjv_silent_unconfig_netweaverdc.txt
- For Tomcat, yjv_silent_unconfig_tomcatdc.txt
- For WebLogic, yjv_silent_unconfig_wlsdc.txt
The response file is a text file, containing parameter names
and values in the format
parameter=value, for example:
KERNEL_HOST01=servername.domain.com
Comment lines begin with a number sign (#). Do not use blank lines.
Any
\ character must be escaped as
\\,
: as
\:, and spaces must
be prefixed with
\, for example:
MS_AM_HOME=C\:\\Program\ Files\\ITCAM\\MS
In the file sections marked as "repeatable", parameters are specific
to a profile path or an application server instance name. For these
parameters, use the path or name as a key, in the format
parameter.key=value. For example:
wls-ALIAS_INSTNAME.INST1=myserver
wls-CUSTOM_SCRIPT_ENABLED.INST1=true
Use the actual values
instead of parameters that are market by <> brackets. For example,
replace
<NetWeaver INSTANCE NAME> with the actual
NetWeaver instance name.
Running the Configuration utility in silent mode
After preparing the response file for a configuration task, run
the configuration utility, specifying the path and name for the response
file.
On Windows systems
complete the following procedure:
- Open a Windows command
prompt window, and change to the ITM_home\installITM directory.
- Invoke the configuration utility as follows. Specify the parameters
in the exact order shown:
kinconfg -nresponse_file_name -ckyj
where
response_file_name is
the name of the response file you have prepared (with full path).
For example:
kinconfg -nC:\TEMP\SILENT.TXT -ckyj
On Linux and UNIX systems complete the following
procedure:
- Change to the ITM_home/bin directory.
- Invoke the configuration utility as follows. Specify the parameters
in the exact order shown:
./itmcmd config -A -p response_file_name yj
where
response_file_name is the name of the response file you have prepared (with full path).
For example:
./itmcmd config -A -p /tmp/silent.txt yj