PACEMAKER(8) | System Administration Utilities | PACEMAKER(8) |
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)
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
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
October 2024 | Pacemaker 2.1.8+20240808.3980678f03-1.2 |