HP Operations Manager

opcragt


The tool opcragt allows you to remotely administer agent processes on HP Operations Manager for Windows managed nodes. The tool can be used to:

Synopsis

opcragt
	 [ -help ] |
	 [ -all | [ [ -r ] -nodegrp <group*gt;... ] <node>... ]
	 [ ( -start | -stop | -status | -primmgr ) [-id <subagent_id>] ] |
	 [ -agent_version ] |
	 [ -get_config_var <config_var>[(<process_name>)] ] |
	 [ -set_config_var <config_var>[(<process_name>)]=[<value>] ]

Description The command opcragt remotely administers the agent processes running on the managed nodes of HP Operations Manager (HPOM) from the HPOM management server. If called without any option, opcragt returns the current status of all agent processes on the specified system(s). This command is recommended for use in the command line prompt. When an operation is executed on more that one node, opcragt displays status immediately after a remote operation finishes for each node.

The tool OvOWRagtS performs the same function as opcragt, but is recommended for use in HPOM tools. OvOWRAgtS displays status when a remote operation finishes on all nodes.

Note NOTE:
The HPOM Control Agent must always be running on the managed nodes, otherwise the HPOM management server cannot access the agent processes remotely.
-help Displays usage message of opcragt. All other options and parameters are ignored.
-start Start or restart configured agents on the specified system or systems.
-stop

Shut down (stop) configured agents except the HP Operations Control Agent on the specified system or systems.

-status Get current status of the agents on the specified system or systems, grouped by subagent_id.
-primmgr Informs the agents on the specified system or systems to change the HPOM primary manager to the calling HPOM management server.
-id<subagent_id> Perform administration on subagents belonging to the <subagent_id>. If no <subagent_id> is specified, administration will be performed for all subagents.
-get_config_var
<config_var>[(<process_name>)]
Return the setting of the configuration variable specified in <config_var>. If a variable has different values set for different processes, all values are reported. The values are queried from both the nodeinfo and opcinfo files on the managed node. If the values in these files differ, the ones from the opcinfo file are reported.
-set_config_var
<config_var>[(<process_name>)]={<value>]
Set the configuration variable specified in <config_var> to the value specified in <value>. If required, a value can also be set for a specific process specified in (<process_name>). Process-specific settings have higher priority than general settings. To reset a value to its default setting, call opcragt -set config_var without any values. Resetting the general settings does not affect the specific settings and vice versa.
Note NOTE:
The values are set in the nodeinfo files on the managed node. Different settings in the opcinfo file will overwrite any settings produced with opcragt.
-all Perform administration on all systems belonging to this HPOM environment.
-r Perform administration also on all subgroups belonging to the specified node groups or groups.
-nodegrp<group>... Perform administration on all systems belonging to the HPOM node group or groups. The <group> name must reflect the name specified in the HPOM Node Group Bank.
<node>... System or list of systems where administration will be performed.If no system has been specified, the local system is used. You can specify the system either as a short system name (for example, mycomputer) or as a fully qualified system name (for example, mycomputer.prod.your.com).

Exit Values

This command will exit with value 0 after successful operation; otherwise the exit value will be set to 1 and an appropriate message will be displayed on stderr.

Restrictions

This command can only be issued by HPOM administrators. This command is only available on the HPOM management server.

After you set a configuration variable with -set_config_var, you must restart the agents for the new values to take effect.

Related Directories

The nodeinfo file is located in the following directory on the managed nodes:

UNIX:

/var/opt/OV/conf/OpC/nodeinfo

AIX:

/var/lpp/OV/conf/OpC/nodeinfo

Windows 2000:

<HP BTO product base dir>\Installed Packages\{790C06B4-844E-11D2-972B-080009EF8C2A}\conf\OpC

Examples