OVCREG(1)OVCREG(1)NAMEovcreg - component registration tool
SYNOPSISovcreg -h|-help
ovcreg-check [<filename>]
ovcreg-add [<filename>]
ovcreg-del [<component>]
ovcreg-version
DESCRIPTIONovcreg is used to register a component with (and de-register the compo‐
nent from) the OvCtrl. The ovcreg command can also be used to check a
component registration file for syntactical correctness.
If the OvCtrl daemon (ovcd) is running at the time of registration, it
will be informed about the new component only if the -add option was
applied and the component is not started. The OvCtrl shows the new com‐
ponent the next time the ovc command is called with the -status option.
If the OvCtrl daemon (ovcd) is running, the component will be stopped
if the -del(ete) option was applied. NOTE: this option will not stop
CORE components, which are denoted by the option CoreProcess in the
registration file. CORE components should be stopped with ovc command
and the -kill option.
Parameters
ovcreg recognizes the following options:
-h|-help
Displays all available options for the ovcreg command.
-check [<filename>]
Checks the syntax of <filename>. <filename> must not contain
more than one component.
-add [<filename>]
Checks the syntax of <filename> and stores a copy in the config‐
uration directory. Adding a component with a name which is
already registered with the OvCtrl will overwrite the original
registration with the new one. <filename> must not contain more
than one component.
-del [<component>]
Stops and de-registers the specified <component> from the OvCtrl
and deletes the specified <component> registration file. NOTE:
the delete option does not stop CORE components.
-version
Displays the version of ovcregAUTHORovcreg 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 the 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
· MS Windows:
C:\Program Files\HP OpenView\data\conf\ctrl\*.xml
Note that the user 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 regis‐
tered 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 component registration file,
opcle.xml to the OvCtrl:
ovcreg-add opcle.xml
· To stop and de-register the component registered as opcle:
ovcreg-del opcle
SEE ALSO
ovc
OVCREG(1)