Skip to content
Controlling an HA Service - HAC documentation hub

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 Getting Started

For more information about HA service status, see Understanding Service Status.

Controlling a Service

All High Availability services configured in a cluster can be controlled from the Dashboard tab.

Upon navigating to Dashboard a summary of the cluster, including a service's state will be shown:

control1

In this example, there is a single service pool1 which is running on the node mgub01, automatic1 and unblocked on both nodes.

Setting a Service Mode

A service's mode can be set to either automatic or manual. Select the service to display additional detail in the sidebar. Next select the 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 Dashboard 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

When the service move is confirmed, the state changes will be displayed on the Dashboard:

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. Select the option to start the service on one of the cluster nodes and the service state changes will be shown in the Dashboard 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

If you do not want a service to start on another node after the stop action completes, set it to manual mode on all nodes before issuing the stop command.

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.