crm_failcount(8) [suse man page]

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

NAME

       crm_failcount - manipulate the failcount attribute on a given resource

SYNOPSIS

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

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

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

DESCRIPTION

       Heartbeat implements a sophisticated method to compute and force failover of a resource to another node in case that resource tends to fail
       on the current node. A resource carries a resource_stickiness attribute to determine how much it prefers to run on a certain node. It also
       carries a resource_failure_stickiness that determines the threshold at which the resource should failover to another node.

       The failcount attribute is added to the resource and increased on resource monitoring failure. The value of failcount multiplied by the
       value of resource_failure_stickiness determines the failover score of this resource. If this number exceeds the preference set for this
       resource, the resource is moved to another node and not run again on the original node until the failure count is reset.

       The crm_failcount command queries the number of failures per resource on a given node. This tool can also be used to reset the failcount,
       allowing the resource to run again on nodes where it had failed too often.

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.

       --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.

       --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.

       --resource-id resource name, -r resource name
	   Specify the name of the resource on which to operate.

EXAMPLES

       Reset the failcount for the resource myrsc on the node node1:

	       crm_failcount -D -U node1 -r my_rsc

       Query the current failcount for the resource myrsc on the node node1:

	       crm_failcount -G -U node1 -r my_rsc

FILES

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

SEE ALSO

       ???, ???, and the Linux High Availability FAQ Web site[1]

AUTHOR

       crm_failcount was written by Andrew Beekhof.

NOTES

	1. Linux High Availability FAQ Web site
	   http://www.linux-ha.org/v2/faq/forced_failover

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

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

NAME

       crm_attribute - manipulate attributes in the CIB

SYNOPSIS

	   crm_attribute [options]

DESCRIPTION

       The crm_attribute command queries and manipulates node attributes and cluster configuration options that are used in the CIB.

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.

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

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

       --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.

       --set-name string, -s string
	   Specify the set of attributes in which to read or write the attribute.

       --attr-name string, -n string
	   Specify the attribute to set or query.

       --type string, -t type
	   Determine to which section of the CIB the attribute should be set or to which section of the CIB the attribute that is queried belongs
	   Possible values are nodes, status, or crm_config.

	   Additional Options:

	   +-----------+--------------------+
	   |Type       | Additional Options |
	   +-----------+--------------------+
	   |nodes      | -(U|u) -n [-s]     |
	   +-----------+--------------------+
	   |status     | -(U|u) -n [-s]     |
	   +-----------+--------------------+
	   |crm_config | -n [-s]	    |
	   +-----------+--------------------+

EXAMPLES

       Query the value of the location attribute in the nodes section for the host myhost in the CIB:

	       crm_attribute -G -t nodes -U myhost -n location

       Query the value of the cluster-delay attribute in the crm_config section in the CIB:

	       crm_attribute -G -t crm_config -n cluster-delay

       Query the value of the cluster-delay attribute in the crm_config section in the CIB. Print just the value:

	       crm_attribute -G -Q -t crm_config -n cluster-delay

       Delete the location attribute for the host myhost from the nodes section of the CIB:

	       crm_attribute -D -t nodes -U myhost -n location

       Add a new attribute called location with the value of office to the set subsection of the nodes section in the CIB (settings applied to the
       host myhost):

	       crm_attribute -t nodes -U myhost -s set -n location -v office

       Change the value of the location attribute in the nodes section for the myhost host:

	       crm_attribute -t nodes -U myhost -n location -v backoffice

FILES

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

SEE ALSO

       ???

AUTHOR

       crm_attribute was written by Andrew Beekhof.

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