opcragt - remotely administer agent processes on HP Operations Manager managed nodes

Note: HP renamed the product called now HP operations manager way too many times. Also it is very inconsistent with using abbreviations. Here we will assume that the term "HP Operations manager" and abbreviations HPOM, OMU, and OVO  mean the same thing :-)

The command opcragt remotely administers the agent processes running on the managed nodes  from the management server. If called without any option, opcragt returns the current status of all agent processes on the specified system(s). This command is only available on the HPOM management server and can be used only by root. 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. 

Here is one example when the status request fails. Here the reason is the firewall is enabled on the node but port 383 was not opened:

# opcragt -status linux8.somewhere.com
Node linux8.somewhere.com:
Cannot get status information from node linux8.somewhere.com.  (OpC40-428)
Network communication problems occurred. (OpC40-427)

-------------------------------------------------------------------------------
 CTRL - CommunicationException:
-------------------------------------------------------------------------------
(ctrl-21) Communication error when executing 'Status' method.
 (bbc-42) Unable to connect to the OV Communication Broker. The connection error returned was: 
  (xpl-316) connect() to '10.20.10.8:383' failed.
   (RTL-239) Connection refused (OpC40-2130)
Failed.

NOTE: the ovcd and ovbbccb processes must be running on the managed nodes, otherwise the HPOM management server cannot access the agent processes remotely. Some functionality is only enabled if the config setting OPCRAGT_USE_THREADS is set to TRUE, as described below.

opcragt
[ -help ]
[ -update ]
[ -all | [ -nodegrp <group>... ] <node>... ] [ ( -start | -stop | -status | -primmgr | -cleanstart ) [-id <subagent_id>] ]
[ -init_install <inst_server> <architecture> <version> <account_password> <inst_drive> ] [ -distrib [ -templates ][ -instrum ] [ -actions ] [ -monitors ] [ -commands ] [-subagts ] [ -force | -purge ] ] [ -subagent ( -install | -uninstall | -reinstall -active ) <subagent name> ] [ -agent_version ]
[ -version ]
[ -get_config_var [<namespace>:]<config_var> ] [ -get_config_var <namespace>: ] [ -set_config_var [<namespace>:]<config_var>=[<value>] ] [ -all | [ -nodegrp <group>... ] <node>... ]

Options

• -help Display usage message of opcragt. All other options and parameters are ignored.
• -update Get latest node-specific configuration from HPOM management server and re-initialize all configured HPOM agents on the specified system(s).
• -start Start or restart configured agents on the specified system(s).
• -stop Shut down (stop) configured agent processes except ovcd and ovbbccb process on the specified sys tem(s).
• -status Get current status of the agents on the specified system(s), grouped by subagent_id. Agents can be in state “running” or “isn’t running".
• -primmgr Informs the agents on the specified system(s) to change the HPOM primary manager to the calling HPOM management server.
• -cleanstart Remove all files in the agent´s temporary direc tory. Start or restart configured agents on the specified system(s). trace and pids files are not removed. <subagent_id> is ignored.
• -id <subagent_id> Perform administration on subagent(s) belonging to the <subagent_id>. If no <subagent_id> is speci fied, administration will be performed for all sub agents.
• -init_install <inst_server> <architecture> <version> <account_pass word> <inst_drive> Install HPOM Windows NT/2000 agent software on specified node from the <inst_server>. <architecture> specifies the architecture of the system to install
• -distrib Distribute HPOM configuration. Distributes all (templates, commands, monitors, actions and category based instrumentation), if no other option is set.
• -templates Distribute or update message source templates, including threshold monitor templates.
• -commands Distribute or update the configured commands.
• -monitors Distribute or update threshold monitor scripts.
• -actions Distribute or update the configured actions.
• -instrum Distribute or update the category based instrumentation.
• -subagts Install all configured, but not yet installed sub agents, on specified node. Force option has no effect on subagent installation.
• -force Force the update of the configuration (subagents are not included in the update). The data is transferred even if it exists already on the node.
• -purge Use this option for removing the instrumentation data from the managed node. Be aware that instrumentation data is cumulated on managed nodes by default.
• -subagent Install, uninstall or reinstall configured sub agents on specified node.
• -install Install subagent on specified node.
• -uninstall Uninstall subagent from specified node.
• -reinstall Reinstall subagent on specified node. Subagent is first uninstalled from node and then installed again.
• -active Mark subagent as installed on specified node in the database.
• -agent_version Return the version number of the HPOM agent soft ware that is currently installed on the node.
• -version Return the version number of the opcragt tool.
• -get_config_var [<name_space>:]<config_var> Return the setting of the configuration variable specified in <config_var> in the namespace speci fied in <name_space>. If the namespace is omitted, it defaults to “eaagt". For example eaagt:OPC_IP_ADDRESS is the same as OPC_IP_ADDRESS.
• -get_config_var <name_space>: Return all variable names and values of namespace <name_space>. Note: this feature is only enabled when setting on HPOM server side the config vari able OPCRAGT_USE_THREADS to TRUE.
• -set_config_var [<name_space>:]<config_var>=[<value>] Set the configuration variable specified in <con fig_var> to the value specified in <value> in the namespace specified in <name_space>. If the names pace is omitted it defaults to “eaagt".
• -all Perform administration on all systems belonging to this HPOM environment.
• -nodegrp <group>... Perform administration on all systems belonging to the HPOM node group(s). 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 will be used. The system can be specified in following ways:

  • <short_sysname> Short system name as returned by ‘uname -n‘ (e.g., opcagt).
  • <hostname> Fully qualified system name as returned by ‘hostname‘ (e.g., opcagt.prod.your.com).
  • <IP_addr> IP address using the standard representation (e.g., 12.132.123.3).
  • #<hex_IP_addr> IP address using its hexadecimal representation (e.g., #f8f78a1).
  • $MGMTSV Distribute to the management server itself. This can only be used to distribute Event Correlation templates to the management server itself. It is important that this is quoted, so that the shell doesn’t replace it as a variable.

Examples

Start all agent processes on system ‘sales’ and ‘opcagt.prod.your.com’: opcragt -start sales opcagt.prod.your.com

Stop all agent processes (except the ovcd and ovbbccb) on system 12.132.123.3:

opcragt -stop 12.132.123.3

Determine current status of all systems belonging to this HPOM environment:

opcragt -status -all

Distribute/update templates and monitors to/on system 12.132.123.3:

opcragt -distrib -templates -monitors 12.132.123.3

Distribute the Event Correlation templates to the management server itself:

opcragt -distrib -templates ‘$MGMTSV’

Force distribution of commands to all managed nodes in this HPOM environment:

opcragt -distrib -commands -force -all

Set the primary HPOM manager on all systems belonging to the HPOM node group hp_ux:

opcragt -primmgr -nodegrp hp_ux

Return the version number of the HPOM agent software that is currently installed on node ‘opcagt.prod.your.com’:

opcragt -agent_version opcagt.prod.your.com

Return the value of OPC_LE_SAVE_STATE configuration setting from eaagt namespace on node ‘opcagt.prod.your.com’:

opcragt -get_config_var eaagt:OPC_LE_SAVE_STATE opcagt.prod.your.com

Set the OPC_LE_SAVE_STATE configuration setting in eaagt namespace on node ‘opcagt.prod.your.com’ to the value ‘TRUE’:

opcragt -set_config_var eaagt:OPC_LE_SAVE_STATE=TRUE opcagt.prod.your.com

Reset the OPC_LE_SAVE_STATE configuration setting in eaagt namespace on node

opcragt -set_config_var eaagt:OPC_LE_SAVE_STATE= opcagt.prod.your.com

Get the installation time for all your managed nodes:

opcragt -get_config_var OPC_INSTALLATION_TIME -all

Get the bbc.http namespace settings for all your managed nodes:

opcragt -get_config_var bbc.http: -all

Tip: Pushing policies assigned to a group to a single node

There is a possibility to push policies assigned to a node group to a single node using opcragt command. This is very convenient option for testing.

opcragt -distib -templates -instrum <node>

Notes

If you want to distribute the nodeinfo file to a managed node, you must first create the file with the command opcsw -get_nodeinfo <nodename>, before you can distribute it with opcragt -distrib <nodename>.

After having set a configuration variable with -set_config_var, the agents must normally be restarted for the new values to take affect.

Some functionality is only enabled when setting OPCRAGT_USE_THREADS to TRUE (command ovconfchg -ovrg server -ns opc -set OPCRAGT_USE_THREADS TRUE) on the HPOM management server. In detail that’s:

The HPOM managed nodes are contacted in parallel (default is to use 50 threads, can be adapted via config setting OPCRAGT_MAX_THREADS). If OPCRAGT_USE_THREADS is not set, the agents are contacted serially.

Options -start, -stop, -status, -primmgr, -get_config_var, -set_con fig_var and -agent_version are handled multi-threaded, others are not.

Unreached agents are listed with their FQDN in the logfile /var/opt/OV/share/tmp/OpC/mgmt_sv/opcragt-<command_option>-failed.log Whereas <command_option> is one of the supported options for multithreading as listed above (status, start, stop, primmgr, ...). The next call with the same option overwrites the log output from the previous.

The -get_config_var mode to show complete namespaces is also bound to the config setting OPCRAGT_USE_THREADS TRUE.

NEWS CONTENTS

• 20110203 : opcragt -distrib does not distribute scripts ( opcragt -distrib does not distribute scripts, Feb 03, 2011 )
• 20110203 : opcragt -distrib ( opcragt -distrib, Feb 03, 2011 )

Old News ;-)

[Feb 03, 2011] opcragt -distrib does not distribute scripts

Aug 29, 2006 | IT Resource Center forums

Thomas Higginson

Hello,

the opcragt -distrib -templates -monitors -commands -force <NODE> does not distribute monitor scripts for Tru64

My OVOU Version is OVOU 8.21 on IA.

On the target /var/opt/OV/bin/instrumentation remains empty but the ovpolicy -list shows the just distributes templates.
What is the source directory on the Server. The following source dir contain the scripts:
/var/opt/OV/share/databases/OpC/mgd_node/customer/hp/alpha/tru64/monitor
and
/var/opt/OV/share/databases/OpC/mgd_node/customer/hp/alpha/tru64/RPC_BBC/m
onitor

How can I configure the SOURCE directory for distribution for a dedicated Servertype?

[Feb 03, 2011] opcragt -distrib

Nov 15, 2010 | IT Resource Center forums

pete_p

Hello - Im trying to update the agent on the OML server but getting the below error. (I have installed the latest agents on he OML server to 08.60.501 agents (Linux only for now) which all went fine, but Im getting the below error, also nothing in the admin chapter 2 on how to upgrade the agent, I imagine its via the opcragt -distrib command, any one if this is correct:

Agent ERROR:

Create distribution data and inform agent...
Warning: HP Operations agent is potentially not installed on node mynode.com
(software-installed flag not set in the database). Continuing with
distribution data (OpC40-730)
Done.

The OML server has the old agent and its running ok - 08.60.005

Any idea's on how to update the agent and reslove this error

Pete

using the admin gui I re-installed the agent and now its running the 08.60.501 agent but I still get the same Warning...

Goran Koruga

Hello.

Run this command:

opcsw -installed "node"

Regards,
Goran

pete_p:

command worked

Recommended Links

Softpanorama Recommended

Top articles

Sites

• opcagt
• ovc

Etc

Society

Groupthink : Two Party System as Polyarchy : Corruption of Regulators : Bureaucracies : Understanding Micromanagers and Control Freaks : Toxic Managers :   Harvard Mafia : Diplomatic Communication : Surviving a Bad Performance Review : Insufficient Retirement Funds as Immanent Problem of Neoliberal Regime : PseudoScience : Who Rules America : Neoliberalism  : The Iron Law of Oligarchy : Libertarian Philosophy

Quotes

War and Peace : Skeptical Finance : John Kenneth Galbraith :Talleyrand : Oscar Wilde : Otto Von Bismarck : Keynes : George Carlin : Skeptics : Propaganda  : SE quotes : Language Design and Programming Quotes : Random IT-related quotes :  Somerset Maugham : Marcus Aurelius : Kurt Vonnegut : Eric Hoffer : Winston Churchill : Napoleon Bonaparte : Ambrose Bierce :  Bernard Shaw : Mark Twain Quotes

Bulletin:

Vol 25, No.12 (December, 2013) Rational Fools vs. Efficient Crooks The efficient markets hypothesis : Political Skeptic Bulletin, 2013 : Unemployment Bulletin, 2010 :  Vol 23, No.10 (October, 2011) An observation about corporate security departments : Slightly Skeptical Euromaydan Chronicles, June 2014 : Greenspan legacy bulletin, 2008 : Vol 25, No.10 (October, 2013) Cryptolocker Trojan (Win32/Crilock.A) : Vol 25, No.08 (August, 2013) Cloud providers as intelligence collection hubs : Financial Humor Bulletin, 2010 : Inequality Bulletin, 2009 : Financial Humor Bulletin, 2008 : Copyleft Problems Bulletin, 2004 : Financial Humor Bulletin, 2011 : Energy Bulletin, 2010 : Malware Protection Bulletin, 2010 : Vol 26, No.1 (January, 2013) Object-Oriented Cult : Political Skeptic Bulletin, 2011 : Vol 23, No.11 (November, 2011) Softpanorama classification of sysadmin horror stories : Vol 25, No.05 (May, 2013) Corporate bullshit as a communication method  : Vol 25, No.06 (June, 2013) A Note on the Relationship of Brooks Law and Conway Law

History:

Fifty glorious years (1950-2000): the triumph of the US computer engineering : Donald Knuth : TAoCP and its Influence of Computer Science : Richard Stallman : Linus Torvalds  : Larry Wall  : John K. Ousterhout : CTSS : Multix OS Unix History : Unix shell history : VI editor : History of pipes concept : Solaris : MS DOS :  Programming Languages History : PL/1 : Simula 67 : C : History of GCC development :  Scripting Languages : Perl history   : OS History : Mail : DNS : SSH : CPU Instruction Sets : SPARC systems 1987-2006 : Norton Commander : Norton Utilities : Norton Ghost : Frontpage history : Malware Defense History : GNU Screen : OSS early history

Classic books:

The Peter Principle : Parkinson Law : 1984 : The Mythical Man-Month :  How to Solve It by George Polya : The Art of Computer Programming : The Elements of Programming Style : The Unix Hater’s Handbook : The Jargon file : The True Believer : Programming Pearls : The Good Soldier Svejk : The Power Elite

Most popular humor pages:

Manifest of the Softpanorama IT Slacker Society : Ten Commandments of the IT Slackers Society : Computer Humor Collection : BSD Logo Story : The Cuckoo's Egg : IT Slang : C++ Humor : ARE YOU A BBS ADDICT? : The Perl Purity Test : Object oriented programmers of all nations : Financial Humor : Financial Humor Bulletin, 2008 : Financial Humor Bulletin, 2010 : The Most Comprehensive Collection of Editor-related Humor : Programming Language Humor : Goldman Sachs related humor : Greenspan humor : C Humor : Scripting Humor : Real Programmers Humor : Web Humor : GPL-related Humor : OFM Humor : Politically Incorrect Humor : IDS Humor : "Linux Sucks" Humor : Russian Musical Humor : Best Russian Programmer Humor : Microsoft plans to buy Catholic Church : Richard Stallman Related Humor : Admin Humor : Perl-related Humor : Linus Torvalds Related humor : PseudoScience Related Humor : Networking Humor : Shell Humor : Financial Humor Bulletin, 2011 : Financial Humor Bulletin, 2012 : Financial Humor Bulletin, 2013 : Java Humor : Software Engineering Humor : Sun Solaris Related Humor : Education Humor : IBM Humor : Assembler-related Humor : VIM Humor : Computer Viruses Humor : Bright tomorrow is rescheduled to a day after tomorrow : Classic Computer Humor

The Last but not Least Technology is dominated by two types of people: those who understand what they do not manage and those who manage what they do not understand ~Archibald Putt. Ph.D

The statements, views and opinions presented on this web page are those of the author (or referenced source) and are not endorsed by, nor do they necessarily reflect, the opinions of the Softpanorama society. We do not warrant the correctness of the information provided or its fitness for any purpose. The site uses AdSense so you need to be aware of Google privacy policy. You you do not want to be tracked by Google please disable Javascript for this site. This site is perfectly usable without Javascript.

Last modified: March 12, 2019