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 (remsh on HP-UX) instead of the default ssh.
-clus Indicates the operations to configure, unconfigure, display, or copy the UUID are for the VCS cluster.
-configure [-force] [-use_llthost | sys1 [sys2...]
Configures the cluster UUID on the nodes that are specified based on whether a cluster UUID exists on any of the VCS nodes:
o If no cluster UUID exists or if the cluster UUID is different on the cluster nodes, then the utility does the following:

* Generates a new cluster UUID using the /opt/VRTSvcs/bin/osuuid.

* Creates the /etc/vx/.uuids/clusuuid file where the utility stores the cluster UUID.

* Configures the cluster UUID on all nodes in the cluster.

o If a cluster UUID exists and if the UUID is same on all the nodes, then the utility retains the UUID.

Use the -force option to discard the existing cluster UUID and create new cluster UUID.

o If some nodes in the cluster have cluster UUID and if the UUID is the same, then the utility configures the existing UUID on the remaining nodes. 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.

COPYRIGHTS

Copyright (c) 2009 Symantec.

All rights reserved.


VCS 5.1 UUIDCONFIG (1M)