Skip to content

Controlling an HA Service

When a new service is added to an RSF-1 High Availability cluster, its state will initially be set to stopped and 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:

control1

In this example, there is a single service lio-pool which is running on the node CentOS8-1, automatic1 and unblocked on both nodes.

Setting a Service Mode

A service's mode can be set to either automatic or 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:

control2

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:

control3

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:

control4

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.

control5

When the service move is confirmed, the state changes will be displayed in the Cluster Control view:

control6

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:

control7

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:

control8

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:

control9


  1. 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.