1clusvcadm(8) Red Hat Cluster Suite clusvcadm(8)
2
6 clusvcadm - Cluster User Service Administration Utility
7
9 clusvcadm [-d <service> ] [-e <service> [-F] ] [-l] [-u] [-S] [-m <mem‐
10 ber> ] [-r <service> ] [-R <service> ] [-M <service> ] [-Z <service> ]
11 [-U <service> ] [-s <service> ] [-c <service> ] [-v]
12
15 The clusvcadm command allows an administrator to enable, disable, relo‐
16 cate, and restart user services in a cluster. In order to perform
17 cluster service operations, the cluster daemons must be running (and
18 have quorum) on the member system on which the command is invoked.
19
22 -d <service>
23 Stops and disables the user service named service
24 -e <service> [-F]
26 Enables and starts the user service named service
27 Normally, rgmanager starts the service locally (i.e. on the host
29 where clusvcadm was run). However, if the -F option is speci‐
30 fied, rgmanager will use the assigned failover domain rules as
31 hints on where to start the service.
32 -l Lock services in preparation for cluster shutdown. This should
34 only be used if the administrator intends to perform a global,
35 cluster wide shutdown. This prevents services from starting
36 (but not stopping, like -Z does). Once the cluster quorum is
37 dissolved, this state is reset. If a new instance of rgmanager
38 boots while others are locked, the behavior is undefined.
39 -u Unlock resource group managers. This allows services to start
41 again.
42 -S Display whether the resource group managers are locked or not.
44 This can be used to verify the correct operation of the -l and
45 -u options, but is only useful for debugging.
46 -m <member>
48 When used in conjunction with either the -e or -r options, this
49 specifies the preferred target member on which to start the ser‐
50 vice.
51 -r <service>
53 Relocates the user service named service to another cluster mem‐
54 ber.
55 -R <service>
57 Restarts the user service named service on the cluster member on
58 which it is currently running.
59 -M <service>
61 Use a special "migration" operation to move the user service
62 named service to another cluster member. Currently, this is
63 only useful for virtual machines. Use of migration usually
64 requires special configuration of the local virtual machine man‐
65 ager in order to work correctly.
66 -Z <service>
68 Freezes the service named service on the cluster member on which
69 it is currently running. This will prevent status checks of the
70 service as well as failover in the event the node fails or
71 rgmanager is stopped.
72 -U <service>
74 Unfreezes the user service named service on the cluster member
75 on which it is currently running. This will re-enable status
76 checks.
77 -s <service>
79 Stops the service named service until a member transition or
80 until it is enabled again.
81 -c <service>
84 Attempt to convalesce the named service by restarting failed,
85 non-critical components.
86 -v Display version information and exit.
89
92 Executing -U (unfreeze) on a service which was frozen in the started
93 state while the service owner is offline results in an undefined (and
94 possibly dangerous) condition. Manually ensure all resources are clear
95 before doing this.
96
99 clustat(8)
100 Jan 2005 clusvcadm(8)