Use the itmcmd config command to configure or reconfigure the execution environment for an agent or server, including the following IBM Tivoli Monitoring items:

• The IP port that the hub monitoring server uses to listen for requests
• The hosts that can run a product
• The location of the hub monitoring server in the network
• The monitoring server an agent connects to
• Whether a monitoring server is a hub or remote server

You can only configure one product at a time. If you reconfigure a monitoring server, you must stop and restart that monitoring server before the changes take effect.

The itmcmd config command prompts for input for the required parameters. Scripts are located in the install_dir/bin directory where install_dir is the directory into which you installed IBM Tivoli Monitoring.

On UNIX® or Linux® only, add the same variable and location to the kbbenv.ini file located in itm_installdir/config/kbbenv.ini. If you do not add the variable to the kbbenv.ini file, it is deleted from the KBBENV file the next time the monitoring server is re-configured.

Use the following syntax to configure a monitoring server:

Use the following syntax to configure a monitoring agent:

Use the following syntax to configure an Oracle agent:

where:

-S

Indicates that you are configuring a monitoring server.

-A

Indicates that you are configuring a monitoring agent.

pc

The product code for the agent or component that you want to configure.

-h install_dir

(Optional) Identifies the installation directory if it is not the one in which the script is located.

Also use this option to take action on an IBM Tivoli Monitoring installation directory other than the one in the current system.

-s

(optional) Option to specify safe mode operation.

Safe mode invokes the JRE with the -nojit option (no just-in-time compiler). If you encounter a Java™ failure error, try running the command as before, but also specifying the -s option.

-a arch

Optional parameter to specify the architecture where arch is one of the abbreviations used to indicate architecture.

This parameter enables you to configure an agent and a monitoring server for an architecture other than the one that you are on. For example, if you are on AIX® and want to configure for Solaris computer, then this option is required. Otherwise the default is the computer you are on.

-u

Adds application support (catalog and attribute files) to a monitoring server for agents that were not installed or for non-UNIX-based agents. If you specify the -u parameter, you must also specify the product code (pc) for the agent or agents. Only used with the -S parameter.

-t tems_name

Required parameter that identifies the name of the monitoring server.

-o instance_name

The instance name for the agent that you want to start.

-g

Displays the configuration settings.

The following example configures the monitoring server ms1:

   itmcmd config -S -t hub_ms1

An exit status of 0 indicates that the command ran successfully. An exit status greater than 0 indicates that there was a failure in the process.