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

NAME

       crm_master - determine which resource instance to promote to master

SYNOPSIS

	   crm_master [-V|-Q] -D [-l lifetime]

	   crm_master [-V|-Q] -G [-l lifetime]

	   crm_master [-V|-Q] -v string [-l string]

DESCRIPTION

       crm_master is called from inside the resource agent scripts to determine which resource instance should be promoted to master mode. It
       should never be used from the command line and is just a helper utility for the resource agents. RAs use crm_master to promote a particular
       instance to master mode or to remove this preference from it. By assigning a lifetime, determine whether this setting should survive a
       reboot of the node (set lifetime to forever) or whether it should not survive a reboot (set lifetime to reboot).

       A resource agent needs to determine on which resource crm_master should operate. These queries must be handled inside the resource agent
       script. The actual calls of crm_master follow a syntax similar to those of the crm_attribute command.

OPTIONS

       --help, -?
	   Print a help message.

       --verbose, -V
	   Turn on debug information.

	       Note
	       Increase the level of verbosity by providing additional instances.

       --quiet, -Q
	   When doing an attribute query using -G, print just the value to stdout. Use this option with -G.

       --get-value, -G
	   Retrieve rather than set the preference to be promoted.

       --delete-attr, -D
	   Delete rather than set the attribute.

       --attr-value string, -v string
	   Value to set. This is ignored when used with -G.

       --lifetime string, -l string
	   Specify how long the preference lasts. Possible values are reboot or forever.

ENVIRONMENT VARIABLES

       OCF_RESOURCE_INSTANCE--the name of the resource instance

FILES

       /var/lib/heartbeat/crm/cib.xml--the CIB (minus status section) on disk.

SEE ALSO

       ???, ???

AUTHOR

       crm_master was written by Andrew Beekhof.

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