May the source be with you, but remember the KISS principle ;-)
Home Switchboard Unix Administration Red Hat TCP/IP Networks Neoliberalism Toxic Managers
(slightly skeptical) Educational society promoting "Back to basics" movement against IT overcomplexity and  bastardization of classic Unix

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

News HP Operations Manager Usage Options Exit values Examples
opcagt Troubleshooting agents node groups Layout groups Humor Etc

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
Cannot get status information from node  (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 '' failed.
   (RTL-239) Connection refused (OpC40-2130)

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.

[ -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>... ]



Start all agent processes on system ‘sales’ and ‘’: opcragt -start sales

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

opcragt -stop

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

opcragt -status -all

Distribute/update templates and monitors to/on system

opcragt -distrib -templates -monitors

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 ‘’:

opcragt -agent_version

Return the value of OPC_LE_SAVE_STATE configuration setting from eaagt namespace on node ‘’:

opcragt -get_config_var eaagt:OPC_LE_SAVE_STATE

Set the OPC_LE_SAVE_STATE configuration setting in eaagt namespace on node ‘’ to the value ‘TRUE’:

opcragt -set_config_var eaagt:OPC_LE_SAVE_STATE=TRUE

Reset the OPC_LE_SAVE_STATE configuration setting in eaagt namespace on node

opcragt -set_config_var eaagt:OPC_LE_SAVE_STATE=

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>


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.

Top Visited
Past week
Past month


Old News ;-)

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

Aug 29, 2006 | IT Resource Center forums

Thomas Higginson


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:

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


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
(software-installed flag not set in the database). Continuing with
distribution data (OpC40-730)

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


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


Run this command:

opcsw -installed "node"



command worked

Recommended Links

Google matched content

Softpanorama Recommended

Top articles




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


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 quotesSomerset Maugham : Marcus Aurelius : Kurt Vonnegut : Eric Hoffer : Winston Churchill : Napoleon Bonaparte : Ambrose BierceBernard Shaw : Mark Twain Quotes


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


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 DOSProgramming Languages History : PL/1 : Simula 67 : C : History of GCC developmentScripting 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-MonthHow 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

Copyright © 1996-2021 by Softpanorama Society. was initially created as a service to the (now defunct) UN Sustainable Development Networking Programme (SDNP) without any remuneration. This document is an industrial compilation designed and created exclusively for educational use and is distributed under the Softpanorama Content License. Original materials copyright belong to respective owners. Quotes are made for educational purposes only in compliance with the fair use doctrine.

FAIR USE NOTICE This site contains copyrighted material the use of which has not always been specifically authorized by the copyright owner. We are making such material available to advance understanding of computer science, IT technology, economic, scientific, and social issues. We believe this constitutes a 'fair use' of any such copyrighted material as provided by section 107 of the US Copyright Law according to which such material can be distributed without profit exclusively for research and educational purposes.

This is a Spartan WHYFF (We Help You For Free) site written by people for whom English is not a native language. Grammar and spelling errors should be expected. The site contain some broken links as it develops like a living tree...

You can use PayPal to to buy a cup of coffee for authors of this site


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