Sun Cluster System Administration Guide for Solaris OS

Administering Sun Cluster Quorum Servers

Sun Cluster Quorum Server provides a quorum device that is not a shared storage device. This section provides procedure for administering Sun Cluster quorum servers, including:

For information about installing and configuring Sun Cluster quorum servers, see How to Install and Configure Quorum Server Software in Sun Cluster Software Installation Guide for Solaris OS.

Overview of the Quorum Server Configuration File

When you install the Sun Cluster software, a default configuration file, /etc/scqsd/scqsd.conf, is created that contains information about a single default quorum server. Each line in the /etc/scqsd/scqsd.conf file has the following format:

/usr/cluster/lib/sc/scqsd [-d quorumdirectory] [-i instancename] -p port

/usr/cluster/lib/sc/scqsd

The full path to where you installed the Sun Cluster software. This value must be /usr/cluster/lib/sc/scqsd.

-d quorumdirectory

The path to the directory where the quorum server can store quorum data.

The quorum server process creates one file per cluster in this directory to store cluster-specific quorum information. By default, the value of this option is /var/scqsd. This directory must be unique for each quorum server that you configure.

-i instancename

A unique name that you choose for the quorum server instance.

-p port

The port number on which the quorum server listens for requests from the cluster. The default port is 9000.

Instance names are optional. If you specify a name for the quorum server, that name must be unique among all quorum servers in your system. If you choose to omit the instance name option, you must refer to the quorum server by the port on which it listens.

Starting and Stopping the Sun Cluster Quorum Server Software

These procedures describe how to start and stop the Sun Cluster software.

By default, these procedures start and stop a single default quorum server unless you have customized the content of the quorum server configuration file, /etc/scqsd/scqsd.conf. The default quorum server is bound on port 9000 and uses the /var/scqsd directory for quorum information.

For information about customizing the quorum server configuration file, see Overview of the Quorum Server Configuration File. For information about installing the Quorum Server software, see How to Install and Configure Quorum Server Software in Sun Cluster Software Installation Guide for Solaris OS.

How to Start a Quorum Server

Become superuser on the host where you want to start the Sun Cluster software.

Use the clquorumserver start command to start the software.
# /usr/cluster/bin/clquorumserver start quorumserver
quorumserver

Identifies the quorum server. You can use the port number on which the quorum server listens. If you provided an instance name in the configuration file, you can use the name instead.

To start a single quorum server, provide either the instance name or port number. To start all quorum servers, when you have multiple quorum servers configured, use the + operand.

Example 6–11 Starting All Configured Quorum Servers

The following example starts all the configured quorum servers.

# /usr/cluster/bin/clquorumserver start +

Example 6–12 Starting a Specific Quorum Server

The following example starts the quorum server that listens on port number 2000.

# /usr/cluster/bin/clquorumserver start 2000

How to Stop a Quorum Server

Become superuser on the host where you want to start the Sun Cluster software.

Use the clquorumserver stop command to stop the software.
# /usr/cluster/bin/clquorumserver stop [-d] quorumserver
-d

Controls if the quorum server starts the next time you boot the machine. If you specify the -d option, the quorum server will not start the next time the machine boots.

quorumserver

Identifies the quorum server. You can use the port number on which the quorum server listens. If you provided an instance name in the configuration file, you can use that name instead.

To stop a single quorum server, provide either the instance name or port number. To stop all quorum servers, when you have multiple quorum servers configured, use the + operand.

Example 6–13 Stopping All Configured Quorum Servers

The following example stops all the configured quorum servers.

# /usr/cluster/bin/clquorumserver stop +

Example 6–14 Stopping a Specific Quorum Server

The following example stops the quorum server that listens on port number 2000.

# /usr/cluster/bin/clquorumserver stop 2000

Displaying Information About the Quorum Server

You can display configuration information about the quorum server. For every cluster that configured the quorum server as a quorum device, this command shows the corresponding cluster name, cluster ID, list of reservation keys, and list of registration keys.

How to Display Information About the Quorum Server

Become the superuser on the host where you want to display the quorum server information.

Users other than the superuser require solaris.cluster.read role-based access control (RBAC) authorization. For more information about RBAC rights profiles, see the rbac(5) man page.

Display the configuration information of the quorum server by using the clquorumserver command.
# /usr/cluster/bin/clquorumserver show quorumserver
quorumserver

Identifies one or more quorum servers. You can specify the quorum server by instance name, or by port number. To display configuration information for all quorum servers, use the + operand.

Example 6–15 Displaying the Configuration of One Quorum Server

The following example displays the configuration information for the quorum server that uses port 9000. The command displays information for every cluster that has the quorum server configured as a quorum device. This information includes the cluster name and ID, and the list of reservation and registration keys on the device.

In the following example, nodes with IDs 1, 2, 3, and 4 of cluster bastille have registered their keys on the quorum server. Also, because Node 4 owns the quorum device reservation, its key is displayed in the reservation list.

# /usr/cluster/bin/clquorumserver show 9000

=== Quorum Server on port 9000 ===

   ---  Cluster bastille (id 0x439A2EFB) Reservation ---

   Node ID:                      4
     Reservation key:            0x439a2efb00000004

   ---  Cluster bastille (id 0x439A2EFB) Registrations ---

   Node ID:                      1
     Registration key:           0x439a2efb00000001

   Node ID:                      2
     Registration key:           0x439a2efb00000002

   Node ID:                      3
     Registration key:           0x439a2efb00000003

   Node ID:                      4
     Registration key:           0x439a2efb00000004

Example 6–16 Displaying the Configuration of Several Quorum Servers

The following example displays the configuration information for three quorum servers, qs1, qs2, and qs3.

# /usr/cluster/bin/clquorumserver show qs1 qs2 qs3

Example 6–17 Displaying the Configuration of All Running Quorum Servers

The following example displays the configuration information for all running quorum servers:

# /usr/cluster/bin/clquorumserver show +

Cleaning Up Stale Quorum Server Cluster Information

To remove a quorum device of type quorumserver, use the clquorum remove command as described in How to Remove a Quorum Device. Under normal operation, this command also removes the quorum server information about the quorum server host. However, if the cluster loses communications with the quorum server host, removing the quorum device does not clean up this information.

The quorum server cluster information becomes invalid in the following circumstances:

When a cluster is decommissioned without first removing the cluster quorum device by using the clquorum remove command
When a quorum_server type quorum device is removed from a cluster while the quorum server host is down

Caution –

If a quorum device of type quorumserver is not yet removed from the cluster, using this procedure to clean up a valid quorum server could compromise the cluster quorum.

How to Clean Up the Quorum Server Configuration Information

Before You Begin

Remove the quorum server quorum device from the cluster, as described in How to Remove a Quorum Device.

Caution –

If the cluster is still using this quorum server, performing this procedure will compromise cluster quorum.

Become the superuser on the quorum server host.

Use the clquorumserver clear command to clean up the configuration file.
# clquorumserver clear -c clustername -I clusterID quorumserver [-y]
-c clustername

The name of the cluster that formerly used the quorum server as a quorum device.

You can obtain the cluster name by running cluster show on a cluster node.

-I clusterID

The cluster ID.

The cluster ID is an 8-digit hexadecimal number. You can obtain the cluster ID by running cluster show on a cluster node.

quorumserver

An identifier for one or more quorum servers.

The quorum server can be identified by a port number or an instance name. The port number is used by the cluster nodes to communicate with the quorum server. The instance name is specified in the quorum server configuration file, /etc/scqsd/scqsd.conf.

-y

Force the clquorumserver clear command to clean up cluster information from the configuration file without first prompting for confirmation.

Use this option only if you are confident that you want outdated cluster information to be removed from the quorum server.

(Optional) If no other quorum devices are configured on this server instance, stop the quorum server.

Example 6–18 Cleaning Up Outdated Cluster Information From the Quorum Server Configuration

This example removes information about the cluster named sc-cluster from the quorum server that uses port 9000.

# clquorumserver clear -c sc-cluster -I 0x4308D2CF 9000
The quorum server to be unconfigured must have been removed from the cluster.  
Unconfiguring a valid quorum server could compromise the cluster quorum.  Do you 
want to continue? (yes or no) y