SUSE Linux Enterprise Server 10 SP2

Chapter 6. Managing a Cluster / crm_master
	crm_failcount		crm_mon

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-id string, -i string

For advanced users only. Identifies the id 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.

Author

crm_master was written by Andrew Beekhof.