IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1
Performing a silent configuration on Windows- Windows - WAS agent
You can use the Configuration utility in Silent mode to perform all configuration tasks for ITCAM Agent for WebSphere Applications. To do this, prepare the response file by modifying a sample provided with the Anent, or use a response file saved during interactive configuration.
All configuration tasks (see Configure ITCAM Agent for WebSphere Applications on Windows) 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, prepare a response file, and then start the configuration utility.
Prepare a response file
To perform a configuration task using silent mode, you can prepare a response file for configuration in any one of two ways:
- 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\SILENTSample response files are located in the ITM_home\TMAITM6 directory. For file names and instructions, see Modify sample response files for configuration tasks.
- Perform the configuration procedure using the GUI (see Configure ITCAM Agent for WebSphere Applications on Windows). In this procedure, check the Save Configuration Setting in a Response File box, and select the name for the response file. Modify the file if necessary, and use it for similar silent configuration on different instances and/or hosts. (Saving a response file is not available for configuring Monitoring Agent connection to the monitoring server).
if you need to modify any paths in the response file, make sure to modify the \ characters to \\, : characters to \:, and prefix spaces with \ (for example, C\:\\Program\ Files\\IBM\\WebSphere). If you need to modify the profile home path for Data Collector Configuration, or the instance name in data collector unconfiguration or upgrade, make sure to replace all occurrences. For more detail on the information in the file, see Modify sample response files for configuration tasks and the comments in the sample response files.
Run 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. Perform 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 -ckyn...where response_file_name is the name of the response file you have prepared (with full path). For example:
kinconfg -nC:\TEMP\SILENT.TXT -ckyn
Modify sample response files for configuration tasks
For each of the configuration tasks for ITCAM Agent for WebSphere Applications, a sample response file is available in the ITM_home\TMAITM6 directory. Make a copy of the file and edit it as required, using the information provided in the comments within the file. For more information on specific configuration options, see Configure ITCAM Agent for WebSphere Applications on Windows.
- Configure 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, 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 ynv_silent_config_agent.txt.
- Configure the data collector to monitor an application server instance: the sample file name is ynv_silent_config_wasdc.txt.
- Unconfigure the data collector from an application server instance: the sample file name is ynv_silent_unconfig_wasdc.txt.
- Configure the data collector communication with the Managing Server: the sample file name is ynv_silent_config_ms.txt.
- Upgrade an application server instance from an older version of the data collector: the sample file name is ynv_silent_upgrade_wasdc.txt.
- Change the data collector maintenance level for monitoring an application server instance: the sample file name is ynv_silent_reconfig_wasdc.txt
- Remove unused data collector maintenance levels: the sample file name is ynv_silent_remove_unused_wasdc.txt
The response file is a text file, containing parameter names and values in the format parameter=value, for example:
KERNEL_HOST01=servername.domain.comComment 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\\MSIn 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:KYN_WAS_HOME.C\:\\Program\ Files\\IBM\\WebSphere\\AppServer\\profiles\\AppSrv01= C\:\\\IBM\\WebSphere\\AppServer KYN_WAS_SERVERS.C\:\\Program\ Files\\IBM\\WebSphere\\AppServer\\profiles\\AppSrv01= cells/ITCAMCell/nodes/ITCAMNode/servers/server1, cells/ITCAMCell/nodes/ITCAMNode/servers/server2 KYN_WAS_HOME.C\:\\Program\ Files\\IBM\\WebSphere\\AppServer\\profiles\\AppSrv02= C\:\\\IBM\\WebSphere\\AppServer KYN_WAS_SERVERS.C\:\\Program\ Files\\IBM\\WebSphere\\AppServer\\profiles\\AppSrv01= cells/ITCAMCell/nodes/ITCAMNode/servers/server3
Parent topic:
Silent installation and configuration on Windows