1PACEMAKER(8)            System Administration Utilities           PACEMAKER(8)
2
3
4

NAME

6       Pacemaker - Part of the Pacemaker cluster resource manager
7

SYNOPSIS

9       crm_attribute -n <attribute> <command> [options]
10

DESCRIPTION

12       crm_attribute - query and update Pacemaker cluster options and node at‐
13       tributes
14

OPTIONS

16   Help Options:
17       -h, --help
18              Show help options
19
20       --help-all
21              Show all help options
22
23       --help-output
24              Show output help
25
26       --help-selections
27              Show selecting options
28
29       --help-command
30              Show command options
31
32       --help-additional
33              Show additional options
34
35   Output Options:
36       --output-as=FORMAT
37              Specify output format as one of: text (default), xml
38
39       --output-to=DEST
40              Specify file name for output (or "-" for stdout)
41
42       --text-fancy
43              Use more highly formatted output (requires --output-as=text)
44
45   Selecting attributes:
46       -i, --id=XML_ID
47              (Advanced) Operate on instance of specified attribute with  this
48              XML ID
49
50       -n, --name=NAME
51              Operate  on  attribute  or  option with this name.  For queries,
52              this is optional, in which case all matching attributes will  be
53              returned.
54
55       -P, --pattern=PATTERN
56              Operate  on  all  attributes  matching this pattern (with -G, or
57              with -v/-D and -l reboot)
58
59       -p, --promotion=RESOURCE
60              Operate on node attribute used as promotion score for  specified
61              resource, or resource given in OCF_RESOURCE_INSTANCE environment
62              variable if none is specified; this also defaults  -l/--lifetime
63              to reboot (normally invoked from an OCF resource agent)
64
65       -s, --set-name=NAME
66              (Advanced)  Operate  on  instance of specified attribute that is
67              within set with this XML ID
68
69   Commands:
70       -D, --delete
71              Delete the attribute/option
72
73       -G, --query
74              Query the current value of the attribute/option.  See also:  -n,
75              -P
76
77       -v, --update=VALUE
78              Update the value of the attribute/option
79
80   Additional options:
81       -d, --default=VALUE
82              (Advanced) Default value to display if none is found in configu‐
83              ration
84
85       -l, --lifetime=LIFETIME
86              Lifetime of the node attribute.  Valid values: reboot, forever
87
88       -N, --node=NODE
89              Set a node attribute for named node (instead of  a  cluster  op‐
90              tion).  See also: -l
91
92       -t, --type=SECTION
93              Which  part  of the configuration to update/delete/query the op‐
94              tion in.  Valid values: crm_config,  rsc_defaults,  op_defaults,
95              tickets
96
97       -z, --utilization
98              Set an utilization attribute for the node.
99
100   Application Options:
101       -$, --version
102              Display software version and exit
103
104       -V, --verbose
105              Increase debug output (may be specified multiple times)
106
107       -q, --quiet
108              Print only the value on stdout
109

EXAMPLES

111       Add new node attribute called 'location' with the value of 'office' for
112       host 'myhost':
113
114              crm_attribute --node myhost --name location --update office
115
116       Query the value of the 'location' node attribute for host 'myhost':
117
118              crm_attribute --node myhost --name location --query
119
120       Change the value of the 'location' node attribute for host 'myhost':
121
122              crm_attribute --node myhost --name location --update backoffice
123
124       Delete the 'location' node attribute for host 'myhost':
125
126              crm_attribute --node myhost --name location --delete
127
128       Query the value of the 'cluster-delay' cluster option:
129
130              crm_attribute --type crm_config --name cluster-delay --query
131
132       Query value of the 'cluster-delay' cluster option and  print  only  the
133       value:
134
135              crm_attribute  --type  crm_config  --name  cluster-delay --query
136              --quiet
137

AUTHOR

139       Written by Andrew Beekhof and the Pacemaker project contributors
140
141
142
143Pacemaker 2.1.5-3.fc37           December 2022                    PACEMAKER(8)