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-selections
              Show selecting options

       --help-command
              Show command options

       --help-additional
              Show additional options

   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

       -P, --pattern=PATTERN
              Operate on all attributes matching this pattern (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

       -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

Pacemaker 2.1.2                                    March 2023                                       PACEMAKER(8)