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

NAME

6       Pacemaker - Part of the Pacemaker cluster resource manager
7

SYNOPSIS

9       cibadmin <command> [options]
10

DESCRIPTION

12       cibadmin - query and edit the Pacemaker configuration
13

OPTIONS

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

EXAMPLES

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

AUTHOR

175       Written by Andrew Beekhof
176

REPORTING BUGS

178       Report bugs to users@clusterlabs.org
179
180
181
182Pacemaker 2.1.2-0.2.rc2.fc35     November 2021                    PACEMAKER(8)