crm_attribute - Man Page
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
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