IBM Tivoli Monitoring > Version 6.3 Fix Pack 2 > Administrator's Guide > Agent-based services > Centralized Configuration > Centralized Configuration startup > Initiating Centralized Configuration with agent environment variables
IBM Tivoli Monitoring, Version 6.3 Fix Pack 2
Set 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.
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.
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.
- 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. 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.
- 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.txtExample 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
Parent topic:
Initiating Centralized Configuration with agent environment variables