.\"Generated by nroff_template.wdt (12-Sep-06). Do NOT edit this output file. Instead, edit the source FM+SGML file.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH ovcoreid "" "" ""
.ds )H Hewlett-Packard Company
.ds ]L
.ds ]W June 2007
.SH NAME
ovcoreid - Manages the unique node identifier OvCoreId on the local node.
.SH "SYNOPSIS"

.PP
ovcoreid -show [-ovrg <\fIOV_Resource_Group\fR>] 

.PP
ovcoreid -create [-force] [-ovrg <\fIOV_Resource_Group\fR>] 

.PP
ovcoreid -set <\fIOvCoreId\fR> [-force] [-ovrg <\fIOV_Resource_Group\fR>] 

.PP
ovcoreid -version 

.PP
ovcoreid -h|-help 

.SH "DESCRIPTION"

.LP
The ovcoreid command is used to display existing OvCoreId values and, in addition, create and set new OvCoreId values on the local node.

.Sh "Parameters"

.LP
The ovcoreid command accepts the following parameters and options:

.TP
-show [-ovrg <\fIOV_Resource_Group\fR>]

Displays the current OvCoreId of the system (configuration setting CORE_ID in namespace [sec.core]). This is the default if no parameters are specified. If the OvCoreId you want to show belongs to an OpenView Resource Group, use the -ovrg option to specify the name of the Resource Group. If an OV Resource Group is specified, the corresponding configuration settings will be read or modified as well.

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

.TP
-create [-force] [-ovrg <\fIOV_Resource_Group\fR>]

Generates a new OvCoreId. If a CORE_ID value already exists, the existing OvCoreId is only overridden when -force is specified. If the OvCoreId you want to show belongs to an OpenView Resource Group, use the -ovrg option to specify the name of the Resource Group. If an OV Resource Group is specified, the corresponding configuration settings will be read or modified as well.

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

.TP
-set [-force] [-ovrg <\fIOV_Resource_Group\fR>]

Sets a specific OvCoreId. The -force option must be used if an OvCoreId value has already been set. If the OvCoreId you want to show belongs to an OpenView resource group, use the -ovrg option to specify the name of the resource group. If an OV Resource Group is specified, the corresponding configuration settings will be read or modified as well.

.TP
-version

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

.TP
-h|-help

Display all available command options.

.SH "AUTHOR"

.LP
ovcoreid was developed by Hewlett-Packard Company.

.SH "EXIT STATUS"

.LP
The following exit values are returned:

.TP
0

All steps were successful.

.TP
1

If -create or -set is used without -force and a value for OvCoreId already exists.

.TP
2

One or more steps were not successful.

.LP
Corresponding error messages are written to stderror.

.LP
NOTE: Changing the OvCoreId of a system is analogous to giving the system a new identity and is an action that should only be executed if the consequences are fully understood. Changing the OvCoreId of a system requires a number of significant changes including the need for a new certificate, and having to do appropriate reconfiguration of the OpenView server(s).

.SH "EXAMPLES"

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

.TP 3
\(bu 
To display the OvCoreId for the local node:

ovcoreid -show 

.TP
\(bu 
To create and set a new OvCoreId on the local node:

ovcoreid -create 

.TP
\(bu 
To set the specified OvCoreId on the local node:

ovcoreid -set <\fIOvCoreId\fR>
.LP

.SH "SEE ALSO"

.LP
ovconfget, ovconfchg.