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, mod‐
15              ified, replaced and deleted.
16
17              Where necessary, XML data will be obtained using the -X, -x,  or
18              -p 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              Recursivly 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       -5, --md5-sum
69              Calculate a CIB digest
70
71       -S, --sync
72              (Advanced) Force a refresh of the CIB to all nodes
73
74   Additional options:
75       -f, --force
76
77       -t, --timeout=value
78              Time (in seconds) to wait before declaring the operation failed
79
80       -s, --sync-call
81              Wait for call to complete before returning
82
83       -l, --local
84              Command takes effect locally.  Should only be used for queries
85
86       -c, --allow-create
87              (Advanced) Allow the target of a -M operation to be  created  if
88              they do not exist
89
90       -n, --no-children
91              (Advanced)  When  querying  an object, do not return include its
92              children 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
102              Retrieve XML from stdin
103
104       -A, --xpath=value
105              A valid XPath to use instead of -o
106
107       -o, --scope=value
108              Limit the scope of the operation to a specific  section  of  the
109              CIB.   Valid values are: nodes, resources, constraints, crm_con‐
110              fig, rsc_defaults, op_defaults, status
111
112       -N, --node=value
113              (Advanced) Send command to the specified host
114

EXAMPLES

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

AUTHOR

169       Written by Andrew Beekhof
170

REPORTING BUGS

172       Report bugs to pacemaker@oss.clusterlabs.org
173
174
175
176Pacemaker 1.1.6-1.fc14          September 2011                    PACEMAKER(8)