Scroll to navigation

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:

Show help options
Show all help options
Show output help
Show selecting options
Show command options
Show additional options

Output Options:

Specify output format as one of: text (default), xml
Specify file name for output (or "-" for stdout)
Use more highly formatted output (requires --output-as=text)

Selecting attributes:

(Advanced) Operate on instance of specified attribute with this XML ID
Operate on attribute or option with this name. For queries, this is optional, in which case all matching attributes will be returned.
Operate on all attributes matching this pattern (with -G, or with -v/-D and -l reboot)
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)
(Advanced) Operate on instance of specified attribute that is within set with this XML ID

Commands:

Delete the attribute/option
Query the current value of the attribute/option. See also: -n, -P
Update the value of the attribute/option

Additional options:

(Advanced) Default value to display if none is found in configuration
Lifetime of the node attribute. Valid values: reboot, forever
Set a node attribute for named node (instead of a cluster option). See also: -l
Which part of the configuration to update/delete/query the option in. Valid values: crm_config, rsc_defaults, op_defaults, tickets
Set an utilization attribute for the node.

Application Options:

-$, --version
Display software version and exit
Increase debug output (may be specified multiple times)
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