Controlling an HA Service
When a new service is added to an RSF-1 High Availability cluster, its state will initially be set to
automatic, after which the cluster will start the service on the services' preferred node.
Once the service is started, its state is controlled using the supplied webapp or command line utilities.
The steps that follow make the following assumptions:
- A cluster has already been created on a set of nodes. For more information about creating a cluster, see Getting started with a ZFS cluster
- A HA service has already been created in the cluster. For more information about creating a ZFS HA service, see Service Creation
For more information about HA service status, see Understanding Service Status.
Controlling a Service from the Browser
All High Availability services configured in a cluster can be controlled from the
Cluster Control tab.
Upon navigating to
Cluster Control a summary of each service's state will be shown for all cluster nodes:
In this example, there is a single service
lio-pool which is running on the node
unblocked on both nodes.
Setting a Service Mode
A service's mode can be set to either
manual from this tab. Click the
Actions button for the service instance that is to be controlled. The display will change to show available actions:
One of the options shown is to set the service mode. If the service is in automatic mode (as in the example), then the option will set the service to manual. If it is already manual, then the option will be to set it to automatic mode.
Select the desired option to change the service's mode, confirm the action and the service status will change:
Moving a Service
A running service is moved from the
Cluster Control tab. It is not necessary to change the service mode (automatic/manual) on either the source or destination node - any required changes to these settings are handled automatically by RSF-1.
The service can only move if it is running on the source node and stopped on the destination. Any other states will block the move operation.
Select the action to move the service from the running node to a remote node:
A confirmation window will be shown with an option to retain failover modes after the service move. This option controls whether the service mode settings move with the service.
When the service move is confirmed, the state changes will be displayed in the
Cluster Control view:
Starting a Service
It is only possible to start a service when it is stopped on all nodes in the cluster. This will be shown in the list of actions:
Select the option to start the service on one of the cluster nodes and the service state changes will be shown in the
Cluster Control view:
Stopping a Service
To stop a service, select the appropriate option from the list of actions for the node that is currently running the service.
When a service is stopped on a node, the service move is set to manual on that node to avoid the service starting again.
Note that if it is not desired for the service to start on another node after the service stop completes, it is important to set the service to manual mode on all nodes before performing the stop action.
When the stop completes, the service will be shown as manual and stopped on all nodes:
Automatic failover mode means a service will failover automatically should the server it is running on fail. When in manual failover mode a service will not automatically fail over. ↩