Environment variables can be used for customizing the agent
environment for Centralized Configuration:
to bootstrap the central configuration server; to control
central configuration client operations; and, when a monitoring agent
acts as a central configuration server, to control operations.
For enterprise monitoring agents, the environment
variables
are set in the agent's environment file; for
system monitor agents, the environment variables
are set in the
pc_silent_install.txt response file.
For more information about installing the
system monitor agent, see
"Monitoring your operating system via a System
Monitor Agent" in the
IBM Tivoli Monitoring Installation
and Setup Guide.
Bootstrap central configuration server
Upon
startup, a monitoring agent first looks for its
configuration load list XML file. If the
configuration load list does not exist, the agent reviews
its environment file for the following variables. The agent constructs
the initial, or
bootstrap, load list from these environment
values to connect to a
central configuration server and
download a
configuration load list.
- IRA_CONFIG_SERVER_URL
- Specifies
the server URL. For example, http://9.52.111.99.
- IRA_CONFIG_SERVER_USERID
- Specifies
the server user ID. Default: itmuser.
- IRA_CONFIG_SERVER_PASSWORD
- Specifies the user password either in plain text or AES encrypted
password string.
- 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.
- IRA_CONFIG_SERVER_FILE_NAME
- Specifies the name of the configuration load list file
on the central configuration server. Default: cnfglist.xml.
Central configuration server operations
The
following agent configuration parameters affect how the agent operates
as a server for
Centralized Configuration:
- IRA_SERVICE_INTERFACE_CONFIG_HOME
- If an agent is being used as a configuration server, this setting
can be used to override the default central configuration repository location.
The default location used to place files to be served by the central configuration server is: install_dir/localconfig.
- The web server HTTP file root is defined by the web server administrator
and cannot be altered. Relative path specifications such as ../../
to reference artifacts outside of defined repository location cannot
be used. In addition, the new repository location cannot be the root
directory.
- IRA_SERVICE_INTERFACE_NAME
- Specify the preferred agent service interface name
to define a more functionally recognized name to replace the agent
generated default name in the format of kpcagent,
where pc is the two-character product code, such
as kntagent or kmqagent;
or pcagent, such as uagent02 to
identify a second installed Universal Agent instance on a system.
- Default:
system.hostname_pc
hostname_pc
- Example: The default
agent-ServicePoint for a Windows OS
Agent is: hostname_nt.
The URL to connect to a central configuration server on
a Windows OS agent running
on host system winhost1 is: https://winhost1:3661///winhost1_nt/winhost1_nt.
If IRA_SERVICE_INTERFACE_NAME= ConfigServer-A, the URL is https://winhost1:3661///ConfigServer-A/ConfigServer-A
- KDE_TRANSPORT
- Use the KDE_TRANSPORT
environment variable to specify a different
port from the default 1920 for HTTP or 3661 for HTTPS.
- Do
not change the default port settings, especially on multifunction UNIX and Linux systems, because many components might
be located on the same system and some of these components might depend
on the default values being used for HTTP and HTTPS ports.
- Note:
The KDE_TRANSPORT variable supersedes and overrides
the KDC_FAMILIES variable. If a KDC_FAMILIES variable
exists in the file, copy the KDC_FAMILIES settings that you want to
keep to the new KDE_TRANSPORT variable. For more information,
see the topic on "Controlling port number assignments" on the
portal server in the IBM Tivoli Monitoring Installation
and Setup Guide.
Problem determination
These
diagnostic
options can be set for the agent component. The output is the ras1
log file.
- IRA_DEBUG_SERVICEAPI=Y
- Agent component name: Service Interface
- IRA_DEBUG_PRIVATE_SITUATION=Y
- Agent component name: private situation
- IRA_DEBUG_TRANSCON=Y
- Agent component name: Transport Conduit
- KDH_DEBUG=D
- Agent component name: Tivoli Monitoring Service
Index HTTP
Service.