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

  1. 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.

  2. Open the silent response file in a text editor.

  3. 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. 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.

  4. 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


Parent topic:

Initiating Centralized Configuration with agent environment variables

+

Search Tips   |   Advanced Search