1PACEMAKER(8) System Administration Utilities PACEMAKER(8)
2
3
4
6 Pacemaker - Part of the Pacemaker cluster resource manager
7
9 cibadmin <command> [options]
10
12 cibadmin - query and edit the Pacemaker configuration
13
15 -?, --help
16 This text
17
18 -$, --version
19 Version information
20
21 -V, --verbose
22 Increase debug output
23
24 Commands:
25 -u, --upgrade
26 Upgrade the configuration to the latest syntax
27
28 -Q, --query
29 Query the contents of the CIB
30
31 -E, --erase
32 Erase the contents of the whole CIB
33
34 -B, --bump
35 Increase the CIB's epoch value by 1
36
37 -C, --create
38 Create an object in the CIB (will fail if object already exists)
39
40 -M, --modify
41 Find object somewhere in CIB's XML tree and update it (fails if
42 object does not exist unless -c is also specified)
43
44 -P, --patch
45 Supply an update in the form of an XML diff (see crm_diff(8))
46
47 -R, --replace
48 Recursively replace an object in the CIB
49
50 -D, --delete
51 Delete first object matching supplied criteria (for example, <op
52 id="rsc1_op1" name="monitor"/>)
53
54 The XML element name and all attributes must match in order for
55 the element to be deleted.
56
57 -d, --delete-all
58 When used with --xpath, remove all matching objects in the con‐
59 figuration instead of just the first one
60
61 -a, --empty
62 Output an empty CIB
63
64 -5, --md5-sum
65 Calculate the on-disk CIB digest
66
67 -6, --md5-sum-versioned
68 Calculate an on-the-wire versioned CIB digest
69
70 Additional options:
71 -f, --force
72
73 -t, --timeout=value
74 Time (in seconds) to wait before declaring the operation failed
75
76 -U, --user=value
77 Run the command with permissions of the named user (valid only
78 for the root and hacluster accounts)
79
80 -s, --sync-call
81 Wait for call to complete before returning
82
83 -l, --local
84 Command takes effect locally (should be used only for queries)
85
86 -c, --allow-create
87 (Advanced) Allow target of --modify/-M to be created if it does
88 not exist
89
90 -n, --no-children
91 (Advanced) When querying an object, do not include its children
92 in the result
93
94 Data:
95 -X, --xml-text=value
96 Retrieve XML from the supplied string
97
98 -x, --xml-file=value
99 Retrieve XML from the named file
100
101 -p, --xml-pipe Retrieve XML from stdin
102
103 -o, --scope=value
104 Limit scope of operation to specific section of CIB
105
106 Valid values: configuration, nodes, resources, constraints,
107 crm_config, rsc_defaults, op_defaults, acls, fencing-topology,
108 tags, alerts
109
110 -A, --xpath=value
111 A valid XPath to use instead of --scope/-o
112
113 -e, --node-path
114 When performing XPath queries, return path of any matches found
115
116 (for example, "/cib/configuration/re‐
117 sources/clone[@id='ms_RH1_SCS']/primitive[@id='prm_RH1_SCS']")
118
119 -N, --node=value
120 (Advanced) Send command to the specified host
121
123 Query the configuration from the local node:
124
125 # cibadmin --query --local
126
127 Query just the cluster options configuration:
128
129 # cibadmin --query --scope crm_config
130
131 Query all 'target-role' settings:
132
133 # cibadmin --query --xpath "//nvpair[@name='target-role']"
134
135 Remove all 'is-managed' settings:
136
137 # cibadmin --delete-all --xpath "//nvpair[@name='is-managed']"
138
139 Remove the resource named 'old':
140
141 # cibadmin --delete --xml-text '<primitive id="old"/>'
142
143 Remove all resources from the configuration:
144
145 # cibadmin --replace --scope resources --xml-text '<resources/>'
146
147 Replace complete configuration with contents of $HOME/pacemaker.xml:
148
149 # cibadmin --replace --xml-file $HOME/pacemaker.xml
150
151 Replace constraints section of configuration with contents of
152 $HOME/constraints.xml:
153
154 # cibadmin --replace --scope constraints --xml-file $HOME/con‐
155 straints.xml
156
157 Increase configuration version to prevent old configurations from being
158 loaded accidentally:
159
160 # cibadmin --modify --xml-text '<cib admin_epoch="ad‐
161 min_epoch++"/>'
162
163 Edit the configuration with your favorite $EDITOR:
164
165 # cibadmin --query > $HOME/local.xml
166
167 # $EDITOR $HOME/local.xml
168
169 # cibadmin --replace --xml-file $HOME/local.xml
170
171 SEE ALSO:
172 crm(8), pcs(8), crm_shadow(8), crm_diff(8)
173
175 Written by Andrew Beekhof
176
178 Report bugs to users@clusterlabs.org
179
180
181
182Pacemaker 2.1.0-0.2.rc1.fc34 May 2021 PACEMAKER(8)