Name

crm_standby — manipulate a node's standby attribute to determine whether resources can be run on this node

Synopsis

crm_standby [-?|-V] -D -u|-U node -r resource

crm_standby  [-?|-V] -G -u|-U node -r resource

crm_standby [-?|-V] -v string -u|-U node -r resource [-l string]

Description

The crm_standby command manipulates a node's standby attribute. Any node in standby mode is no longer eligible to host resources and any resources that are there must be moved. Standby mode can be useful for performing maintenance tasks, such as kernel updates. Remove the standby attribute from the node when it should become a fully active member of the cluster again.

By assigning a lifetime to the standby attribute, determine whether the standby setting should survive a reboot of the node (set lifetime to forever) or should be reset with reboot (set lifetime to reboot). Alternatively, remove the standby attribute and bring the node back from standby manually.

Options

--help, -?

Print a help message.

--verbose, -V

Turn on debug information.


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.

--delete-attr, -D

Specify the attribute to delete.

--attr-value string, -v string

Specify the value to use. This option is ignored when used with -G.

--attr-id string, -i string

For advanced users only. Identifies the id attribute..

--node-uuid node_uuid, -u node_uuid

Specify the UUID of the node to change.

--node-uname node_uname, -U node_uname

Specify the uname of the node to change.

--lifetime string, -l string

Determine how long this preference lasts. Possible values are reboot or forever.


If a `forever` value exists, it is always used by the CRM instead of any `reboot` value.

Examples

Have a local node go to standby:

crm_standby -v true

Have a node (node1) go to standby:

crm_standby -v true -U node1

Query the standby status of a node:

crm_standby -G -U node1

Remove the standby property from a node:

crm_standby -D -U node1

Have a node go to standby for an indefinite period of time:

crm_standby -v true -l forever -U node1

Have a node go to standby until the next reboot of this node:

crm_standby -v true -l reboot -U node1

Files

/var/lib/heartbeat/crm/cib.xml—the CIB (minus status section) on disk. Editing this file directly is strongly discouraged.

Author

crm_standby was written by Andrew Beekhof.