Administering Oracle Solaris Cluster Quorum Servers

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

• Starting and Stopping the Quorum Server Software

• How to Start a Quorum Server

• How to Stop a Quorum Server

• Displaying Information About the Quorum Server

• Cleaning Up Stale Quorum Server Cluster Information

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

Starting and Stopping the Quorum Server Software

These procedures describe how to start and stop the Oracle Solaris 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 installing the Quorum Server software, see How to Install and Configure Quorum Server Software in Oracle Solaris Cluster Software Installation Guide. For information on changing the value of the quorum time-out, see Changing the Quorum's Default Time-out.

How to Start a Quorum Server

1. Become superuser on the host where you want to start the Oracle Solaris Cluster software.
2. 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-10 Starting All Configured Quorum Servers

The following example starts all the configured quorum servers.

# /usr/cluster/bin/clquorumserver start +

Example 6-11 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

1. Become superuser on the host where you want to start the Oracle Solaris Cluster software.
2. 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-12 Stopping All Configured Quorum Servers

The following example stops all the configured quorum servers.

# /usr/cluster/bin/clquorumserver stop +

Example 6-13 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

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

2. 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-14 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-15 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-16 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.

---

1. Become the superuser on the quorum server host.
2. 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.

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

Example 6-17 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