NAME¶
clusvcadm - Cluster User Service Administration Utility
SYNOPSIS¶
clusvcadm [-d <service> ] [-e
<service> [-F] ] [-l] [-u] [-S]
[-m <member> ] [-r <service>
] [-R <service> ] [-M
<service> ] [-Z <service> ]
[-U <service> ] [-s <service>
] [-c <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> [-F]
- Enables and starts the user service named service
Normally, rgmanager starts the service locally (i.e. on the host where
clusvcadm was run). However, if the -F option is specified,
rgmanager will use the assigned failover domain rules as hints on where to
start the 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.
- -c <service>
- Attempt to convalesce the named service by restarting failed,
non-critical components.
- -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)