HP Operations Manager

ovoreqcheckagt


The tool ovoreqcheckagt enables local HP Operations agent prerequisite checking from the command line on the node. It parses requirements from the local configuration file, checks the node, and prints out the report in either a detailed or summarized format. The default location of the configuration file is the current directory. You can specify a custom file with -cfg <config_file>.

UNIX-specific Information

The tool consists of three files: ovoreqcheckagt, ovoreqcheckagt.awk, and ovoreqcheck.cfg. These files must be transferred from the agent package directory on the server (for example, C:\Program Files\HP\HP BTO Software\data\packages\HPUX\B.11.00) to the node where the agent prerequisites will be checked. The ovoreqcheckagt script needs to be made executable with the command chmod +x ./ovoreqcheckagt.

Windows-specific Information

The tool consists of two files: ovoreqcheckagt.exe and ovoreqcheck.cfg. These files must be transferred from the agent package directory on the server (for example, C:\Program Files\HP\HP BTO Software\data\packages\Windows\Windows_manual) to the node where the agent prerequisites will be checked.

Command Synopsis

ovoreqcheckagt (-det | -sum) -agt_comm_type <agent_comm_type>
			 -agt_bin_format <agent_bin_format> [-cfg <config_file>]
ovoreqcheckagt -req [<system>] [-agt_comm_type <agent_comm_type>]
			 [-agt_bin_format <agent_bin_format>] [-cfg <config_file>]
ovoreqcheckagt -allsystems [-cfg <config_file>] 
ovoreqcheckagt -ver
ovoreqcheckagt -help
 
-help Prints tool usage and description.
-det Prints detailed result of requirements and recommendations validation. All prerequisites are displayed regardless if they have passed or failed.
-sum Prints summary result of requirements and recommendations validation. Only failed prerequisites are displayed.
-req [<system>] Shows requirements and recommendations for the specified operating system. If the system is not given, it shows prerequisites for all supported systems.
-allsystems Prints the list of all supported systems.
-agt_comm_type <agent_comm_type> Specifies the agent communication type for this node. If you specify -det or -sum, this parameter is required. Valid values for <agent_comm_type> are DCE and HTTPS.
-agt_bin_format <agent_bin_format>

Specifies the agent binary format for this node. If you specify -det or -sum, this parameter is required. Valid values for <agent_bin_format> are as follows:

  • Alpha
  • IPF32
  • IPF64
  • PA-RISC
  • PowerPC
  • SPARC
  • x64
  • x86
-cfg <config_file> Specifies a custom configuration file (default file is .\ovoreqcheck.cfg).
-ver Prints the version of the ovoreqcheckagt tool.

Exit Values

Exit value indicates prerequisite checking status:

0 - All checked prerequisites (requirements and recommendations) are OK.

1 - All requirements are OK; at least one recommendation has failed.

2 - All requirements are OK; at least one recommendation could not be checked.

3 - At least one requirement has failed.

55 - No prerequisites specified for <system> system.

101 - Client does not have administrative privileges on the node. Prerequisites can be checked only with administrative rights.

102 - At least one requirement could not be checked (it is unknown whether requirement is OK or not); all other successfully checked requirements are OK.

103 - Checked node is not available; either there is no network connection or firewall ports are not opened.

104 - Node (name) cannot be resolved

105 - The platform/OS version on node xxx may not yet be supported - consult the latest support matrix ; if platform is supported ignore prerequisite check and check prerequisites manually.

106 - Node’s platform properties (System Type, Operating System, Version) are not set.

107 - Cannot discover platform.