Tivoli Monitoring, Version 6.2

tacmd restartAgent

Description

Use the tacmd restartAgent command to start or restart the given agents or the agents for the given managed systems. The OS agent must be running on the local computer prior to issuing this command for a non-OS agent.

If you have the authority to restart agents and you specify only the agent type, you do not need to log in to restart an agent on a local computer.

When you specify only an agent type, all agents of that type are restarted on the local computer.

To start an OS agent, you must issue the command on the local computer where the agent is installed.

Note:
You cannot use this command to restart a non-default Universal Agent instance that you created manually. Use the itmcmd agent command with the -p parameter instead to restart a non-default Universal Agent instance.

CLI syntax

tacmd restartAgent {-m|--system} system ...
                   [{-f|--force}]

tacmd restartAgent {-n|--node} managed-os
                   {-t|--type} type ...
                   {-f|--force}]

tacmd restartAgent {-t|--type} type ...
                   [{-f|--force}]

where:

-m|--system system ...
Specifies the managed system or managed systems on which to restart the non-OS agents.
-t|--type type ...
Specifies one or more OS agents or agent instances to restart. The value of type is scoped to the node level.
-n|--node managed-os
Identifies the node on the computer where you want to restart an agent. The node is the installation directory for all agents. The name of a node includes the computer where the OS agent is installed and the product code for the OS agent. For example, stone.ibm.com:LZ is the name of the node on computer stone.ibm.com, which has a Linux® OS agent installed.
-f|--force
Restarts the specified agents without confirmation.

CLI example

This command restarts the Universal Agent agent with name stone:UA.

   tacmd restartAgent -m stone:UA

This command restarts all UM agents on the node Primary:STONE:NT.

   tacmd restartAgent -n Primary:STONE:NT -t UM

This command restarts all NT agents on the local system.

   tacmd restartAgent -t NT

Return values

See Table 2.

Related commands

tacmd stopAgent

tacmd startAgent




Feedback

[ Top of Page | Previous Page | Next Page | Contents | Index ]