Use the tacmd configureSystem command to edit configuration options of an existing agent. The agent is restarted so the new configuration parameters can take effect. Specify the configuration data through the parameter pair section.name=value. If a parameter is specified with an equal sign but without a value, the specified parameter is removed from the agent configuration.

You must specify at least one configuration parameter when you configure the agent. If the agent requires no configuration parameters, use the -p parameter to set the Run-as setting for the agent.

where:

-m|--system system

Identifies the agent (managed system) that you want to configure.

-p|--property section.name=value ...

Specifies one or more section.name=value pairs that identify configuration properties to update, where section specifies the name of the section containing the key value pair, name specifies the name of the configuration property, and value specifies the property value.

You must specify at least one property when you configure an agent. If you don't have any agent-specific configuration properties, set the run as user, as described below.

See the agent user's guide for the agent that you are configuring for a list of available configuration properties.

In addition to the agent-specific configuration properties, you can also configure the Run-as settings, specifying the user ID under which an agent runs. Use the following parameters:

_UNIX_STARTUP_.Username=user

On UNIX®, the user name under which to run the agent. Note that you can only use this option if the OS agent running on the UNIX computer is started as the root user (or another user with privileges to su). You cannot change the run-as setting if your OS agent runs as a non-root user.

If you have already configured the run as user (for example, through the Manage Tivoli Enterprise Monitoring Services utility), this value defaults to what you have already set. If you have not configured the run as user previously, the default user is the user that is running the OS agent on the computer.

_WIN32_STARTUP_.Username=user

On Windows®, the user name under which to run the agent.

If you have already configured the run as user (for example, through the Manage Tivoli Enterprise Monitoring Services utility), this value defaults to what you have already set. If you have not configured the run as user previously, the default user is LocalSystem (InteractWithDesktop=0).

_WIN32_STARTUP_.Password=pwd

The password for the run as user that you specified with _WIN32_STARTUP_Username.

_WIN32_STARTUP_.LocalSystem={0|1}

Indicates whether you want to use the LocalSystem user to start the agent. Use 1 to specify to use the user and 0 to specify not to use the user.

You must also specify the _WIN32_STARTUP_.InteractWithDesktop={0|1} parameter.

_WIN32_STARTUP_.InteractWithDesktop={0|1}

Indicates whether the LocalSystem can interact with the computer desktop. Use 1 to specify that it can and 0 to specify that it cannot.

This command re-configures the universal agent on stone with the file_unix.mdl MDL file.

   tacmd configureSystem -m stone:UA -p UA.CONFIG="file_unix.mdl"

See Table 2.

tacmd addSystem