HP Operations Manager for Windows

ovcoreid


NAME

ovcoreid

- manage the unique node identifier OvCoreId on the local node.

SYNOPSIS

ovcoreid -show [-ovrg <OV_Resource_Group>] 
ovcoreid -create [-force] [-ovrg <OV_Resource_Group>] 
ovcoreid -set <OvCoreId> [-force] [-ovrg <OV_Resource_Group>] 
ovcoreid -version 
ovcoreid -h|-help 

DESCRIPTION

You can use the ovcoreid command to display existing OvCoreId values, and to create and set new OvCoreId values on the local node.

Parameters

The ovcoreid command accepts the following parameters and options:

-show [-ovrg <OV_Resource_Group>]
Displays the current OvCoreId of the system (configuration setting CORE_ID in namespace [sec.core]). This is the default if you do not specify any parameters. If the OvCoreId you want to show belongs to an HPOM Resource Group, use the -ovrg option to specify the name of the HPOM Resource Group. If you specify an HPOM Resource Group, the corresponding configuration settings are read or modified as well.

If you specify a non-existent HPOM Resource Group, ovcoreid displays the local OvCoreId.

-create [-force] [-ovrg <OV_Resource_Group>]
Generates a new OvCoreId. If a CORE_ID value already exists, the existing OvCoreId is overridden only if you specify -force. If the OvCoreId you want to show belongs to an HPOM Resource Group, use the -ovrg option to specify the name of the HPOM Resource Group. If you specify an HPOM Resource Group, the corresponding configuration settings are read or modified as well.

If you specify a non-existent HPOM Resource Group, ovcoreid displays an error.

-set [-force] [-ovrg <OV_Resource_Group>]
Sets a specific OvCoreId. You must use the -force option if an OvCoreId value has already been set. If the OvCoreId you want to show belongs to an HPOM Resource Group, use the -ovrg option to specify the name of the resource group. If you specify an HPOM Resource Group, the corresponding configuration settings are read or modified as well.

-version
Returns the version of the tool (the component version).

-h|-help
Display all available command options.

AUTHOR

ovcoreid was developed by Hewlett-Packard Company.

EXIT STATUS

The following exit values are returned:

0
All steps were successful.

1
If you use -create or -set without -force and a value for OvCoreId already exists.

2
One or more steps were not successful.

Corresponding error messages are written to stderror.

Caution CAUTION:
Changing the OvCoreId of a system is analogous to giving the system a new identity. You should execute this action only if you fully understand the consequences. Changing the OvCoreId of a system requires a number of significant changes, including a new certificate and reconfiguration of HPOM servers.

EXAMPLES

The following examples show you how to use the ovcoreid command:

SEE ALSO

ovconfget(1), ovconfchg(1).