NAME¶
clusvcadm - Cluster User Service Administration Utility
SYNOPSIS¶
clusvcadm [-d <service> ] [-e
<service> ] [-l] [-u] [-S] [-m
<member> ] [-r <service> ]
[-R <service> ] [-M <service>
] [-Z <service> ] [-U
<service> ] [-s <service> ]
[-v]
DESCRIPTION¶
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.
SEE ALSO¶
clustat(8)