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.
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 |
The full path to where you installed the Sun Cluster software. This value must be /usr/cluster/lib/sc/scqsd.
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.
A unique name that you choose for the quorum server instance.
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.
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.
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 |
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.
The following example starts all the configured quorum servers.
# /usr/cluster/bin/clquorumserver start + |
The following example starts the quorum server that listens on port number 2000.
# /usr/cluster/bin/clquorumserver start 2000 |
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 |
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.
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.
The following example stops all the configured quorum servers.
# /usr/cluster/bin/clquorumserver stop + |
The following example stops the quorum server that listens on port number 2000.
# /usr/cluster/bin/clquorumserver stop 2000 |
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.
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 |
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.
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 |
The following example displays the configuration information for three quorum servers, qs1, qs2, and qs3.
# /usr/cluster/bin/clquorumserver show qs1 qs2 qs3 |
The following example displays the configuration information for all running quorum servers:
# /usr/cluster/bin/clquorumserver show + |
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
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.
Remove the quorum server quorum device from the cluster, as described in How to Remove a Quorum Device.
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] |
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.
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.
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.
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.
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 |