opcagt

The command opcagt administers the agent processes running on an HP Operations Manager managed node. This command can be integrated in the startup procedure of the computer. If used without any option, opcagt returns the current status of the agent services running on the local system.

Command synopsis

Windows

opcagt [ -help | -h | -stop | -kill | -start | -restart | -cleanstart | -status | -type [-verbose]]

Linux

./opcagt [-help | -stop | -kill | -start | -restart | -cleanstart | -status | -type [-verbose]]

Options

-help | -h

Displays the opcagt options.

-stop

Stops the Event/Action Agent and Coda.

-kill

Stops the HPOM Core functionality.

-start

Starts the Event/Action Agent and Coda.

-restart

Restarts the HPOM Core functionality.

-cleanstart

Clears the agent's buffers and then starts the agent. This option discards any messages that the agent added to the message buffer but did not send. This option also removes any scheduled tasks that agent added to the action queue but did not start.

-status

Displays the status of Event/Action Agent and Coda.

-type

Displays the type of Event/Action Agent.

-verbose

Displays detailed information about the Event/Action Agent.

-version

Displays version information.

Exit values

This command exits with a value of zero after successful operation. If a failure occurs, the exit value is set to one and an appropriate message displays.

In addition, the HP Operations agents record any warnings or errors in the local HPOM log file:

• Windows

  '%OvAgentDir%\log\OpC\opcerror'

• UNIX

  /var/opt/OV/log/OpC/opcerror

Restrictions

This command can be run only by a user with administrative rights.

Windows examples

To start all agent services on the local system

opcagt -start