The
clusvcadm
command allows an administrator to enable, disable, relocate, and restart
user services in a cluster. In order to perform cluster service operations,
the cluster daemons must be running (and have quorum) on the member system
on which the command is invoked.
OPTIONS
-d <service>
Stops and disables the user service named
service
-e <service>
Enables and starts the user service named
service
-l
Lock services in preparation for cluster shutdown. This should only
be used if the administrator intends to perform a global, cluster
wide shutdown. This prevents services from starting (but not stopping,
like
-Z
does). Once the cluster quorum is dissolved, this state is reset.
If a new instance of rgmanager boots while others are locked, the
behavior is undefined.
-u
Unlock resource group managers. This allows services to start again.
-S
Display whether the resource group managers are locked or not. This
can be used to verify the correct operation of the -l and -u
options, but is only useful for debugging.
-m <member>
When used in conjunction with either the
-e
or
-r
options, this specifies the
preferred
target member on which to start the
service.
-r <service>
Relocates the user service named
service
to another cluster member.
-R <service>
Restarts the user service named
service
on the cluster member on which it is currently running.
-M <service>
Use a special "migration" operation to move the user service named
service
to another cluster member. Currently, this is only useful for
virtual machines. Use of migration usually requires special
configuration of the local virtual machine manager in order
to work correctly.
-Z <service>
Freezes the service named
service
on the cluster member on which it is currently running. This will
prevent status checks of the service as well as failover in the
event the node fails or rgmanager is stopped.
-U <service>
Unfreezes the user service named
service
on the cluster member on which it is currently running. This will
re-enable status checks.
-s <service>
Stops the service named
service
until a member transition or until it is enabled again.
-v
Display version information and exit.
NOTES
Executing
-U
(unfreeze) on a service which was frozen in the
started
state while the service owner is offline results in an undefined
(and possibly dangerous) condition. Manually ensure all resources are
clear before doing this.