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] [data]
10

DESCRIPTION

12       cibadmin - Provides direct access to the cluster configuration.
13
14       Allows  the  configuration, or sections of it, to be queried, modified,
15       replaced and deleted.
16
17       Where necessary, XML data will be obtained using  the  -X,  -x,  or  -p
18       options.
19

OPTIONS

21       -?, --help
22              This text
23
24       -$, --version
25              Version information
26
27       -V, --verbose
28              Increase debug output
29
30   Commands:
31       -u, --upgrade
32              Upgrade the configuration to the latest syntax
33
34       -Q, --query
35              Query the contents of the CIB
36
37       -E, --erase
38              Erase the contents of the whole CIB
39
40       -B, --bump
41              Increase the CIB's epoch value by 1
42
43       -C, --create
44              Create  an  object  in the CIB.  Will fail if the object already
45              exists.
46
47       -M, --modify
48              Find the object somewhere in the CIB's XML tree and  update  it.
49              Fails if the object does not exist unless -c is specified
50
51       -P, --patch
52              Supply an update in the form of an xml diff (See also: crm_diff)
53
54       -R, --replace
55              Recursively replace an object in the CIB
56
57       -D, --delete
58              Delete  the first object matching the supplied criteria, Eg. <op
59              id="rsc1_op1" name="monitor"/>
60
61              The tagname and all attributes must match in order for the  ele‐
62              ment to be deleted
63
64       -d, --delete-all
65              When  used with --xpath, remove all matching objects in the con‐
66              figuration instead of just the first one
67
68       -a, --empty
69              Output an empty CIB
70
71       -5, --md5-sum
72              Calculate the on-disk CIB digest
73
74       -6, --md5-sum-versioned
75              Calculate an on-the-wire versioned CIB digest
76
77   Additional options:
78       -f, --force
79
80       -t, --timeout=value
81              Time (in seconds) to wait before declaring the operation failed
82
83       -U, --user=value
84              Run the command with permissions of the named user  (valid  only
85              for the root and hacluster accounts)
86
87       -s, --sync-call
88              Wait for call to complete before returning
89
90       -l, --local
91              Command takes effect locally.  Should only be used for queries
92
93       -c, --allow-create
94              (Advanced)  Allow  the  target  of a --modify,-M operation to be
95              created if they do not exist
96
97       -n, --no-children
98              (Advanced) When querying an object, do not  return  include  its
99              children in the result
100
101   Data:
102       -X, --xml-text=value
103              Retrieve XML from the supplied string
104
105       -x, --xml-file=value
106              Retrieve XML from the named file
107
108       -p, --xml-pipe Retrieve XML from stdin
109
110       -o, --scope=value
111              Limit  the  scope  of the operation to a specific section of the
112              CIB.
113
114              Valid values are:  nodes,  resources,  constraints,  crm_config,
115              rsc_defaults, op_defaults, status
116
117       -A, --xpath=value
118              A valid XPath to use instead of --scope,-o
119
120       -e, --node-path
121              When performing XPath queries, return the address of any matches
122              found.
123
124              Eg:  /cib/configuration/resources/clone[@id='ms_RH1_SCS']/primi‐
125              tive[@id='prm_RH1_SCS']
126
127       -N, --node=value
128              (Advanced) Send command to the specified host
129

EXAMPLES

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

AUTHOR

184       Written by Andrew Beekhof
185

REPORTING BUGS

187       Report bugs to users@clusterlabs.org
188
189
190
191Pacemaker 2.0.0-5.fc29            April 2019                      PACEMAKER(8)