UUIDCONFIG(1M)

NAME

uuidconfig - manage the cluster UUID (Universally Unique Id) on the VCS nodes.

SYNOPSIS

uuidconfig.pl [-rsh] -clus -configure [-force] [-use_llthost | sys1 [sys2...]]
uuidconfig.pl [-rsh] -clus -unconfigure [-use_llthost | sys1 [sys2...]]
uuidconfig.pl [-rsh] -clus -display -use_llthost | sys1 [sys2 sys3...]
uuidconfig.pl [-rsh] -clus -copy -from_sys sys -to_sys sys1 [sys2...]

AVAILABILITY

VRTSvcs

DESCRIPTION

The uuidconfig command line utility can display, configure, and unconfigure the UUID (universally unique id) on the cluster nodes.

OPTIONS

-rsh Uses the communication protocol rsh, instead of the default ssh, for executing commands on remote nodes.

-clus Indicates the operations to configure, unconfigure, display, or copy the UUID are for the VCS cluster.

-configure [-force] [-use_llthost | sys1 [sys2...]]

Depending on the cluster UUID configuration on the cluster nodes, the utility does the following:

o If the nodes have a cluster UUID configured, the utility attempts to reuse the existing cluster UUID.

o If the cluster UUID is different on the cluster nodes, or if the -force option is specified, the utility discards the existing cluster UUID and configures a new cluster UUID.

o If no cluster UUID exists on the cluster nodes, the utility configures a new cluster UUID. The -use_llthost option indicates that the utility must use the system names from the /etc/llthosts file.

-unconfigure [-use_llthost | sys1 [sys2...]]
Unconfigures the cluster UUID from all the nodes and removes the /etc/vx/.uuids/clusuuid file.
The -use_llthost option indicates that the utility must use the system names from the /etc/llthosts file.

-display -use_llthost | sys1 [sys2 sys3...]
Displays the cluster UUIDs on all the nodes.
The -use_llthost option indicates that the utility must use the system names from the /etc/llthosts file.

-copy -from_sys sys -to_sys sys1 [sys2...]
Copies the cluster UUID from a system that is specified using the -from_sys option to all systems that are specified using the -to_sys option.

FILES

/etc/llthosts LLT configuration file with a list of all the nodes in the cluster.
/etc/vx/.uuids/clusuuid File where VCS stores the cluster UUID.

VCS 7.4.3

UUIDCONFIG(1M)

-rsh	Uses the communication protocol rsh, instead of the default ssh, for executing commands on remote nodes.
-clus	Indicates the operations to configure, unconfigure, display, or copy the UUID are for the VCS cluster.
-configure [-force] [-use_llthost \| sys1 [sys2...]]

o	If the nodes have a cluster UUID configured, the utility attempts to reuse the existing cluster UUID.
o	If the cluster UUID is different on the cluster nodes, or if the -force option is specified, the utility discards the existing cluster UUID and configures a new cluster UUID.
o	If no cluster UUID exists on the cluster nodes, the utility configures a new cluster UUID. The -use_llthost option indicates that the utility must use the system names from the /etc/llthosts file.
-unconfigure [-use_llthost \| sys1 [sys2...]]
	Unconfigures the cluster UUID from all the nodes and removes the /etc/vx/.uuids/clusuuid file. The -use_llthost option indicates that the utility must use the system names from the /etc/llthosts file.
-display -use_llthost \| sys1 [sys2 sys3...]
	Displays the cluster UUIDs on all the nodes. The -use_llthost option indicates that the utility must use the system names from the /etc/llthosts file.
-copy -from_sys sys -to_sys sys1 [sys2...]
	Copies the cluster UUID from a system that is specified using the -from_sys option to all systems that are specified using the -to_sys option.