FreeBSD Manual Pages
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 attrib- utes 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 re- source, or resource given in OCF_RESOURCE_INSTANCE environment vari- able if none is specified; this also defaults -l/--lifetime to re- boot (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: clus- ter -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 configura- tion -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 --promo- tion/-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 --promo- tion/-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 Pacemaker 2.1.11 August 2026 PACEMAKER(8)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=crm_attribute&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>