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 -v, -D, or
57              -G)
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       -W, --wait=UNTIL
98              Wait  for some event to occur before returning.  Values are 'no'
99              (wait only for the attribute daemon to acknowledge the request),
100              'local'  (wait  until the change has propagated to where a local
101              query will return the request value, or the value set by a later
102              request),  or 'cluster' (wait until the change has propagated to
103              where a query anywhere on the cluster will return the  requested
104              value,  or  the value set by a later request).  Default is 'no'.
105              (with -N, and one of -D or -u)
106
107       -z, --utilization
108              Set an utilization attribute for the node.
109
110   Application Options:
111       -$, --version
112              Display software version and exit
113
114       -V, --verbose
115              Increase debug output (may be specified multiple times)
116
117       -q, --quiet
118              Print only the value on stdout
119

EXAMPLES

121       Add new node attribute called 'location' with the value of 'office' for
122       host 'myhost':
123
124              crm_attribute --node myhost --name location --update office
125
126       Query the value of the 'location' node attribute for host 'myhost':
127
128              crm_attribute --node myhost --name location --query
129
130       Change the value of the 'location' node attribute for host 'myhost':
131
132              crm_attribute --node myhost --name location --update backoffice
133
134       Delete the 'location' node attribute for host 'myhost':
135
136              crm_attribute --node myhost --name location --delete
137
138       Query the value of the 'cluster-delay' cluster option:
139
140              crm_attribute --type crm_config --name cluster-delay --query
141
142       Query  value  of  the 'cluster-delay' cluster option and print only the
143       value:
144
145              crm_attribute --type  crm_config  --name  cluster-delay  --query
146              --quiet
147

AUTHOR

149       Written by Andrew Beekhof and the Pacemaker project contributors
150
151
152
153Pacemaker 2.1.7-0.3.rc2.fc38     November 2023                    PACEMAKER(8)
Impressum