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/configura‐
117              tion/resources/clone[@id='ms_RH1_SCS']/primi‐
118              tive[@id='prm_RH1_SCS']")
119
120       -N, --node=value
121              (Advanced) Send command to the specified host
122

EXAMPLES

124       Query the configuration from the local node:
125
126              # cibadmin --query --local
127
128       Query just the cluster options configuration:
129
130              # cibadmin --query --scope crm_config
131
132       Query all 'target-role' settings:
133
134              # cibadmin --query --xpath "//nvpair[@name='target-role']"
135
136       Remove all 'is-managed' settings:
137
138              # cibadmin --delete-all --xpath "//nvpair[@name='is-managed']"
139
140       Remove the resource named 'old':
141
142              # cibadmin --delete --xml-text '<primitive id="old"/>'
143
144       Remove all resources from the configuration:
145
146              # cibadmin --replace --scope resources --xml-text '<resources/>'
147
148       Replace complete configuration with contents of $HOME/pacemaker.xml:
149
150              # cibadmin --replace --xml-file $HOME/pacemaker.xml
151
152       Replace  constraints  section  of  configuration   with   contents   of
153       $HOME/constraints.xml:
154
155              #  cibadmin  --replace --scope constraints --xml-file $HOME/con‐
156              straints.xml
157
158       Increase configuration version to prevent old configurations from being
159       loaded accidentally:
160
161              #        cibadmin        --modify        --xml-text        '<cib
162              admin_epoch="admin_epoch++"/>'
163
164       Edit the configuration with your favorite $EDITOR:
165
166              # cibadmin --query > $HOME/local.xml
167
168              # $EDITOR $HOME/local.xml
169
170              # cibadmin --replace --xml-file $HOME/local.xml
171
172   SEE ALSO:
173              crm(8), pcs(8), crm_shadow(8), crm_diff(8)
174

AUTHOR

176       Written by Andrew Beekhof
177

REPORTING BUGS

179       Report bugs to users@clusterlabs.org
180
181
182
183Pacemaker 2.0.5-10.fc33          December 2020                    PACEMAKER(8)