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: 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
|
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
|
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: 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). |
After you set a configuration variable with
-set_config_var
, you must restart the agents for the
new values to take effect.
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
opcragt -start sales opcagt.prod.your.com
opcragt -stop 12.132.123.3
opcragt -status -all
hp_ux
:
opcragt -primmgr -nodegrp hp_ux
'opcagt.prod.your.com'
:
opcragat -agent_version opcagt.prod.your.com
'opcctla'
on node 'opcagt.prod.your.com
.
opcragt -get_config_var OPC_COMM_PORT_RANGE
(opcctla)
opcagt.prod.your.com
'opcctla'
on
node 'opcagt.prod.your.com to the value '1234':
opcragt -set_config_var OPC_COMM_PORT_RANGE(opcctla)=1234
opcagt.prod.your.com
'opcagt.prod.your.com'
to their default values:
opcragt -set_config_var OPC_COMM_PORT_RANGE
opcagt.prod.your.com
'opcctla'
on
node 'opcagr.prod.your.com'
to the default value:
'opcragt -set_config_var OPC_COMM_PORT_RANGE(opcctla)
opcagt.prod.your.com