Pacemaker − Part of the Pacemaker cluster resource manager
crm_attribute -n <attribute> <command> [options]
crm_attribute − query and update Pacemaker cluster options and node attributes
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)
Selecting
attributes:
−a, −−all
With −L/−−list−options, include advanced and deprecated options in the output. This is always treated as true when −−output−as=xml is specified.
−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:
−L,
−−list−options=TYPE
List all available options of the given type. Allowed values: cluster
−D, −−delete
Delete the attribute/option (with −n or −P)
−G, −−query
Query the current value of the attribute/option. See also: −n, −P
−v, −−update=VALUE
Update the value of the attribute/option (with −n or −P)
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
−−score
Treat new attribute values as atomic score updates where possible (with −−update/−v, when running against a CIB file or updating an attribute outside the status section; enabled by default if −−promotion/−p is specified)
This currently happens by default and cannot be disabled, but
this default behavior is deprecated and will be removed in a future release (exception: this will remain the default with −−promotion/−p). Set this flag if this behavior is desired.
This option takes effect when updating XML attributes. For an
attribute named "name", if the new value is "name++" or "name+=X" for some score X, the new value is set as follows:
* If attribute "name" is not already set to some value in
the element being updated, the new value is set as a literal string.
* If the new value is "name++", then the attribute is set to
its existing value (parsed as a score) plus 1.
* If the new value is "name+=X" for some score X, then the
attribute is set to its existing value plus X, where the existing value and X are parsed and added as scores.
Scores are integer values capped at INFINITY and −INFINITY.
Refer to Pacemaker Explained and to the char2score() function for more details on scores, including how they’re parsed and added.
−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
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
Written by Andrew Beekhof and the Pacemaker project contributors