CRM_UUID(8)							  [FIXME: manual]						       CRM_UUID(8)

NAME

       crm_uuid - get a node's UUID

SYNOPSIS

	   crm_uuid [-w|-r]

DESCRIPTION

       UUIDs are used to identify cluster nodes to ensure that they can always be uniquely identified. The crm_uuid command displays and modifies
       the UUID of the node on which it is run.

       When Heartbeat is first started on a node, it creates a UUID (in binary form) in /var/lib/heartbeat/hb_uuid. This file can be read and
       written by means of crm_uuid.

	   Note
	   There are very rare circumstances when crm_uuid should be used to modify the UUID file. The most common is when it is necessary to set
	   a node's UUID to a known value when creating a new cluster.

OPTIONS

       --write, -w
	   Write a UUID value to the /var/lib/heartbeat/hb_uuid file.

	       Warning
	       Use the -w option with care, because it creates a new UUID value for the node on which it is run. Various scripts across the
	       cluster might still use the old value, causing the cluster to fail because the node is no longer associated with the old UUID
	       value. Do not change the UUID unless you changed all references to it as well.

       --read, -r
	   Read the UUID value and print it to stdout.

SEE ALSO

       /var/lib/heartbeat/hb_uuid

AUTHOR

       crm_uuid was written by Andrew Beekhof.

[FIXME: source] 						    07/05/2010							       CRM_UUID(8)