IBM Tivoli Monitoring, Version 6.3

Setting Centralized Configuration environment variables during system monitor agent installation

You can use a system monitor agent's Centralized Configuration environment variables in the silent response file to point to the central configuration server and download the initial (bootstrap) configuration load list.

About this task

System monitor agents are started at the end of their silent installation. Without local configuration files, the agents run but do not run private situations or send SNMP alerts or EIF events. Using Centralized Configuration, the agent can retrieve these files and begin using them immediately. The system monitoring agent installation uses entries in the silent response file to create entries in the agent's environment file.

For more information about the silent response file, how to configure it, and how to invoke it, see "Monitoring your operating system via a System Monitor Agent" in the IBM Tivoli Monitoring Installation and Setup Guide.

Procedure

Locate the pc_silent_install.txt response file (such as ux_silent_install.txt) on the Tivoli Monitoring Agent installation media and make a copy of it.
Open the silent response file in a text editor.
Specify how to connect to the central configuration server and download the initial configuration load list.
SETENV_ IRA_CONFIG_SERVER_URL

Specifies the server URL. For example, http://9.52.111.99.

SETENV_ IRA_CONFIG_SERVER_USERID

Specifies the server user ID. Default: itmuser.

SETENCR_IRA_CONFIG_SERVER_PASSWORD

Specifies the user password as an AES encrypted password string. If you want to enter it in plain text, prefix the environment variable with SETENV_ instead of SETENCR_.

SETENV_ IRA_CONFIG_SERVER_FILE_PATH

Specifies the path to the configuration load list on the central configuration server. The default is loadlist/@PRODUCT@. See Configuration load list keyword substitution for a list of keywords.

SETENV_ IRA_CONFIG_SERVER_FILE_NAME

Specifies the name of the configuration load list file on the central configuration server. Default: cnfglist.xml.

The SETENV_parameter=value statements create parameter=value statements in the agent environment file; SETENCR_parameter=value statements create parameter={AES256:keyfile:a}encryptedvalue statements.
Invoke the silent installation procedure as described in the Example of a silent installation file named nt_silent_installcc.txt that is invoked on a Windows system:
```
silentInstall.cmd -p nt_silent_installcc.txt
```
Example of a silent installation file named ux_silent_installcc.txt in the /opt/IBM/sma path on a UNIX system:
```
silentInstall.sh -h /opt/IBM/sma/ -p ux_silent_installcc.txt
```

Example

This example shows how a copy of nt_silent_install.txt from the installation media might be edited to install a system monitor agent on the local computer and configure it for Centralized Configuration:

Before

;License Agreement=I agree to use the software only in accordance with 
the installed license.

;SETENV_IRA_CONFIG_SERVER_URL=http://configserver.domain.com:1920
;SETENV_IRA_CONFIG_SERVER_USERID=itmuser
;SETENCR_IRA_CONFIG_SERVER_PASSWORD=plaintext_or_encrypted_using_itmpwdsnmp
;SETENV_IRA_CONFIG_SERVER_FILE_PATH=initloadlist/@PRODUCT@
;SETENV_IRA_CONFIG_SERVER_FILE_NAME=cnfglist.xml

After

License Agreement=I agree to use the software only in accordance with 
the installed license.

SETENV_IRA_CONFIG_SERVER_URL=http://mysystem.mydomain.ibm.com:1920
SETENV_IRA_CONFIG_SERVER_USERID=itmuser
SETENCR_IRA_CONFIG_SERVER_PASSWORD={AES256:keyfile:a}encryptedpassword
SETENV_IRA_CONFIG_SERVER_FILE_PATH=bootstraploadlist
SETENV_IRA_CONFIG_SERVER_FILE_NAME=cnfglist.xml

Feedback