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

       -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 and the Pacemaker project contributors