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