| 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)
- --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 -G, or with -v/-D and -l reboot)
- -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
- -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
| July 2023 | Pacemaker 2.1.5 |