PACEMAKER

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
AUTHOR

NAME

Pacemaker − Part of the Pacemaker cluster resource manager

SYNOPSIS

crm_attribute -n <attribute> <command> [options]

DESCRIPTION

crm_attribute − query and update Pacemaker cluster options and node attributes

OPTIONS

Help Options:
−h
, −−help

Show help options

−−help−all

Show all help options

−−help−output

Show output help

−−help−selections

Show selecting options

−−help−command

Show command options

−−help−additional

Show additional options

Output Options:
−−output−as
=FORMAT

Specify output format as one of: text (default), xml

−−output−to=DEST

Specify file name for output (or "−" for stdout)

−−text−fancy

Use more highly formatted output (requires −−output−as=text)

Selecting attributes:
−i
, −−id=XML_ID

(Advanced) Operate on instance of specified attribute with this XML ID

−n, −−name=NAME

Operate on attribute or option with this name. For queries, this is optional, in which case all matching attributes will be returned.

−P, −−pattern=PATTERN

Operate on all attributes matching this pattern (with −v, −D, or −G)

−p, −−promotion=RESOURCE

Operate on node attribute used as promotion score for specified resource, or resource given in OCF_RESOURCE_INSTANCE environment variable if none is specified; this also defaults −l/−−lifetime to reboot (normally invoked from an OCF resource agent)

−s, −−set−name=NAME

(Advanced) Operate on instance of specified attribute that is within set with this XML ID

Commands:
−D
, −−delete

Delete the attribute/option

−G, −−query

Query the current value of the attribute/option. See also: −n, −P

−v, −−update=VALUE

Update the value of the attribute/option

Additional options:
−d
, −−default=VALUE

(Advanced) Default value to display if none is found in configuration

−l, −−lifetime=LIFETIME

Lifetime of the node attribute. Valid values: reboot, forever

−N, −−node=NODE

Set a node attribute for named node (instead of a cluster option). See also: −l

−t, −−type=SECTION

Which part of the configuration to update/delete/query the option in. Valid values: crm_config, rsc_defaults, op_defaults, tickets

−W, −−wait=UNTIL

Wait for some event to occur before returning. Values are ’no’ (wait only for the attribute daemon to acknowledge the request), ’local’ (wait until the change has propagated to where a local query will return the request value, or the value set by a later request), or ’cluster’ (wait until the change has propagated to where a query anywhere on the cluster will return the requested value, or the value set by a later request). Default is ’no’. (with −N, and one of −D or −u)

−z, −−utilization

Set an utilization attribute for the node.

Application Options:
−$, −−version

Display software version and exit

−V, −−verbose

Increase debug output (may be specified multiple times)

−q, −−quiet

Print only the value on stdout

EXAMPLES

Add new node attribute called ’location’ with the value of ’office’ for host ’myhost’:

crm_attribute −−node myhost −−name location −−update office

Query the value of the ’location’ node attribute for host ’myhost’:

crm_attribute −−node myhost −−name location −−query

Change the value of the ’location’ node attribute for host ’myhost’:

crm_attribute −−node myhost −−name location −−update backoffice

Delete the ’location’ node attribute for host ’myhost’:

crm_attribute −−node myhost −−name location −−delete

Query the value of the ’cluster−delay’ cluster option:

crm_attribute −−type crm_config −−name cluster−delay −−query

Query value of the ’cluster−delay’ cluster option and print only the value:

crm_attribute −−type crm_config −−name cluster−delay −−query −−quiet

AUTHOR

Written by Andrew Beekhof and the Pacemaker project contributors