ovcreg

NAME

ovcreg

- component registration tool

SYNOPSIS

ovcreg -h|-help 

ovcreg -check [<filename>] 

ovcreg -add [<filename>] 

ovcreg -del [<component>] 

ovcreg -version 

DESCRIPTION

You use the ovcreg command to register a component with (and de-register the component from) OvCtrl. You can also use ovcreg to check a component registration file for syntactical correctness.

If the OvCtrl daemon (ovcd) is running at the time of registration, it is informed about the new component only if you applied the -add option and if you did not start the component. OvCtrl shows the new component the next time the ovc command is called with the -status option.

If the OvCtrl daemon (ovcd) is running, the component is stopped if you applied the -del (delete) option. Note that this option does not stop CORE components, which are denoted by the option CoreProcess in the registration file. You can stop CORE components with ovc command and the -kill option.

Parameters

The ovcreg command recognizes the following options:

-h|-help

Displays all available options for the ovcreg command.

-check [<filename>]

Checks the syntax of <filename>. The <filename> option may not contain more than one component.

-add [<filename>]

Checks the syntax of <filename>, and stores a copy in the configuration directory. Adding a component with a name which is already registered with OvCtrl overwrites the original registration with the new one. The <filename> option may not contain more than one component.

-del [<component>]

Stops and de-registers the specified <component> from OvCtrl, and deletes the specified <component> registration file. Note that the delete option does not stop CORE components.

-version

Displays the version of ovcreg.

AUTHOR

ovcreg was developed by Hewlett-Packard Company.

EXIT STATUS

The following exit values are returned:

0

Success. The syntax of the file is correct, and the registration file is successfully added or deleted.

1

Wrong usage.

2

Parsing error.

3

Error deleting registration file.

5

Error writing XML file.

6

Component is not registered.

7

Error stopping component.

8

Error deleting component.

FILES

Registration files for components registered with OvCtrl for the supported platforms reside in the following locations:

• AIX, HP-UX, Linux, Solaris:

  /var/opt/OV/conf/ctrl/*.xml

• True64:

  /usr/var/opt/OV/conf/ctrl/*.xml

• Microsoft Windows:

  C:\Program Files\HP\HP BTO Software\conf\ctrl\*.xml

Users can change the specified default location for the registration files on machines running Microsoft Windows.

EXAMPLES

The following examples show how to use the ovcreg command and some of its options to control and display important information about registered components:

• To check the syntax of the component registration file opcle.xml:

  ovcreg -check opcle.xml

• To check the syntax of the component registration file opcle.xml, and add the component defined in the file to OvCtrl:

  ovcreg -add opcle.xml

• To stop and de-register the component registered as opcle:

  ovcreg -del opcle

SEE ALSO

ovc(1)