1CCS(8) System Manager's Manual CCS(8)
2
6 ccs - Cluster Configuration System
7
9 ccs [-h hostname | -f filename] [options]
10
12 ccs allows an administrator to create, modify and view a cluster con‐
13 figuration file on a remote node through ricci or on a local file sys‐
14 tem. Using ccs an administrator can also start and stop the cluster
15 services on one or all of the nodes in a configured cluster.
16
18 Generally all command lines must specify either a hostname or filename
19 to act upon.
20 MAIN OPTIONS
22 --help Display this help and exit
23 -h, --host host
25 Cluster node to perform actions on
26 --usealt
28 If primary node name is unavailable, attempt to connect to ricci
29 on the alt interface (only works from a cluster member)
30 -f, --file file
32 File to perform actions on
33 -i, --ignore
35 Ignore validation errors in cluster.conf file
36 -p, --password
38 Ricci user password for node running ricci
39 --getconf
41 Print current cluster.conf file
42 --setconf
44 Use the file specified by '-f' to send to the host specified
45 with '-h'
46 --checkconf
48 If file is specified, verify that all the nodes in the file have
49 the same cluster.conf as the file. If a host is specified then
50 verify that all nodes in the host's cluster.conf file have the
51 identical
52 --getschema
54 Print current cluster schema file (if using -h use schema from
55 network, if using -f use local schema)
56 --sync Sync config file to all nodes and optionally activating that
58 configuration on all nodes
59 --activate
61 Activate config on node (use this option with --sync to activate
62 config on all nodes)
63 -b, --backup
65 Backup cluster.conf file before changes in ~/.ccs/backup direc‐
66 tory
67 -d, --debug
69 Display debugging information to help troubleshoot connection
70 issues with ricci
71 --exp tag [location] [options]
73 Expert mode to add elements not currently defined in ccs
74 --exprm location
76 Expert mode to remove elements not currently defined in ccs
77 CLUSTER OPERATIONS
79 --createcluster cluster
80 Create a new cluster.conf (removing old one if it exists)
81 --getversion
83 Get the current cluster.conf version
84 --setversion <n>
86 Set the cluster.conf version
87 --incversion
89 Increment the cluster.conf version by 1
90 --startall [--noenable|--nodisable]
92 Start *AND* enable cluster services on reboot on all nodes (if
93 --noenable or --nodisable is specified cluster services will
94 only be started)
95 --stopall [--noenable|--nodisable]
97 Stop *AND* disable cluster services on reboot for all nodes (if
98 --noenable or --nodisable is specified cluster services will
99 only be stopped)
100 --start [--noenable|--nodisable]
102 Start *AND* enable cluster services on reboot for host specified
103 with -h or localhost if no host is provided (if --noenable or
104 --nodisable is specified cluster services will only be started)
105 --stop [--noenable|--nodisable]
107 Stop *AND* disable cluster services on reboot for host specified
108 with -h or localhost if no host is provided (if --noenable or
109 --nodisable is specified cluster services will only be stopped)
110 NODE OPERATIONS
112 --lsnodes
113 List all nodes in the cluster
114 --addnode <node>
116 Add node <node> to the cluster
117 --rmnode <node>
119 Remove a node from the cluster
120 --nodeid <nodeid>
122 Specify nodeid when adding a node
123 --votes <votes>
125 Specify number of votes when adding a node
126 --addalt <node name> <alt name> [alt options]
128 Add an altname to a node for RRP
129 --rmalt <node name>
131 Remove an altname from a node for RRP
132 FENCING OPERATIONS
134 --lsfenceopts [fence type]
135 List available fence devices. If a fence type is specified,
136 then list options for the specified fence type
137 --lsfencedev
139 List all of the fence devices configured
140 --lsfenceinst [<node>]
142 List all of the fence methods and instances on the specified
143 node or all nodes if no node is specified
144 --addmethod <method> <node>
146 Add a fence method to a specific node
147 --rmmethod <method> <node>
149 Remove a fence method from a specific node
150 --addfencedev <device name> [fence device options]
152 Add fence device. Fence devices and parameters can be found in
153 online documentation in 'Fence Device Parameters'
154 --rmfencedev <fence device name>
156 Remove fence device
157 --addfenceinst <fence device name> <node> <method> [options] [--noun‐
159 fence]
160 Add fence instance. Fence instance parameters can be found in
161 online documentation in 'Fence Device Parameters'. Using
162 --nounfence prevents ccs from automatically including an unfenc‐
163 ing section for agents that require unfencing (ie. fence_scsi,
164 fence_sanlock, etc.)
165 --rmfenceinst <fence device name> <node> <method>
168 Remove all instances of the fence device listed from the given
169 method and node
170 --addunfenceinst <fence device name> <node> [options]
172 Add an unfence instance
173 --rmunfenceinst <fence device name> <node>
175 Remove all instances of the fence device listed from the unfence
176 section of the node
177 FAILOVER DOMAIN OPERATIONS
179 --lsfailoverdomain
180 Lists all of the failover domains and failover domain nodes con‐
181 figured in the cluster
182 --addfailoverdomain <name> [restricted] [ordered] [nofailback]
184 Add failover domain
185 --rmfailoverdomain <name>
187 Remove failover domain
188 --addfailoverdomainnode <failover domain> <node> [priority]
190 Add node to given failover domain
191 --rmfailoverdomainnode <failover domain> <node>
193 Remove node from failover domain
194 SERVICE OPERATIONS
196 --lsserviceopts [service type]
197 List available services. If a service type is specified, then
198 list options for the specified service type
199 --lsresourceopts [service type]
201 An alias to --lsserviceopts
202 --lsservices
204 List currently configured services and resources in the cluster
205 --addresource <resource type> [resource options] ...
207 Add global cluster resources to the cluster Resource types and
208 variables can be found in the online documentation under 'HA
209 Resource Parameters'
210 --rmresource <resource type> [resource options]
213 Remove specified resource with resource options
214 --addservice <servicename> [service options] ...
216 Add service to cluster
217 --rmservice <servicename>
219 Removes a service and all of its subservices
220 --addaction <resource/name> <action_name> <action_option=val>
222 Add an action to the specified resource.
223 --rmaction <resource name> [<action_name> [action options]]
225 Remove all actions from resource, or actions matching action
226 name and options specified
227 --addvm <virtual machine name> [vm options] ...
229 Adds a virtual machine to the cluster
230 --rmvm <virtual machine name>
232 Removes named virtual machine from the cluster
233 --addsubservice <servicename> <subservice> [service options] ...
235 Add individual subservices, if adding child services, use ':' to
236 separate parent and child subservices and brackets to identify
237 subservices of the same type
238 Subservice types and variables can be found in the online docu‐
239 mentation under 'HA Resource Parameters'
240 To add a nfsclient subservice as a child of the 2nd nfsclient
241 subservice in the 'service_a' service use the following example:
242 ccs <...> --addsubservice service_a nfsclient[1]:nfsclient
243 ref=/test
244 --rmsubservice <servicename> <subservice>
246 Removes a specific subservice specified by the subservice, using
247 ':' to separate elements and brackets to identify between sub‐
248 services of the same type.
249 To remove the 1st nfsclient child subservice of the 2nd
250 nfsclient subservice in the 'service_a' service, use the follow‐
251 ing example:
252 ccs <...> --rmsubservice service_a nfsclient[1]:nfsclient
253 QUORUM OPERATIONS
255 --lsquorum
256 List quorum options and heuristics
257 --setquorumd [quorumd options] ...
259 Add quorumd options
260 --addheuristic [heuristic options] ...
262 Add heuristics to quorumd
263 --rmheuristic [heuristic options] ...
265 Remove heuristic specified by heurstic options
266 MISC OPTIONS
268 --lsmisc
269 List all of the misc options
270 --settotem [totem options]
272 Set totem options
273 --setuidgid uid=<uid> gid=<gid>
275 Set uidgid options
276 --rmuidgid uid=<uid> gid=<gid>
278 Remove uidgid entry matching specified uid/gid
279 --setdlm [dlm options]
281 Set dlm options
282 --setrm [resource manager options]
284 Set resource manager options
285 --setcman [cman options]
287 Set cman options
288 --setmulticast [multicast address] [multicast options]
290 Sets the multicast address to use (or removes it if no multicast
291 address is given)
292 --setaltmulticast [alt multicast address] [alt multicast options]
294 Sets the alt multicast address to use (or removes it if no alt
295 multicast address is given)
296 --setfencedaemon [fence daemon options]
298 Set fence daemon options
299 --setlogging [logging options]
301 Set logging options
302 --addlogging [logging daemon options]
304 Add a logging daemon (see cluster.conf for options)
305 --rmlogging [logging daemon options]
307 Remove the logging daemon with the specified options
308
310 ~/.ccs/cacert.config ~/.ccs/cacert.pem ~/.ccs/privkey.pem
311 Automatically generated certificate files used to authenticate
312 with ricci.
313
315 Create and start a 3 node cluster with apc fencing:
316 ccs -h host1 --createcluster mycluster
317 ccs -h host1 --addnode host1
318 ccs -h host1 --addnode host2
319 ccs -h host1 --addnode host3
320 ccs -h host1 --addmethod primary host1
321 ccs -h host1 --addmethod primary host2
322 ccs -h host1 --addmethod primary host3
323 ccs -h host1 --addfencedev myfence agent=fence_apc ipaddr=192.168.0.200
324 login=apc passwd=apc
325 ccs -h host1 --addfenceinst myfence host1 primary port=1
326 ccs -h host1 --addfenceinst myfence host2 primary port=2
327 ccs -h host1 --addfenceinst myfence host3 primary port=3
328 ccs -h host1 --sync --activate
329 ccs -h host1 --startall
330
333 Chris Feist <cfeist@redhat.com>
334
336 ricci(8), cluster.conf(5), ccs_tool(8)
337
339 Fence Device Parameters http://docs.redhat.com/docs/en-
340 US/Red_Hat_Enterprise_Linux/6/html/Cluster_Administration/ap-fence-
341 device-param-CA.html
342 HA Resource Parameters http://docs.redhat.com/docs/en-US/Red_Hat_Enter‐
343 prise_Linux/6/html/Cluster_Administration/ap-ha-resource-params-CA.html
344 CCS(8)