|Skip Navigation Links|
|Exit Print View|
|Oracle Solaris Cluster System Administration Guide Oracle Solaris Cluster 4.1|
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:
For information about installing and configuring Oracle Solaris Cluster quorum servers, see How to Install and Configure Oracle Solaris Cluster Quorum Server Software in Oracle Solaris Cluster Software Installation Guide.
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 Oracle Solaris Cluster 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.
# /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.
Example 6-9 Starting All Configured Quorum Servers
The following example starts all the configured quorum servers.
# /usr/cluster/bin/clquorumserver start +
Example 6-10 Starting a Specific Quorum Server
The following example starts the quorum server that listens on port number 2000.
# /usr/cluster/bin/clquorumserver start 2000
# /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.
Example 6-11 Stopping All Configured Quorum Servers
The following example stops all the configured quorum servers.
# /usr/cluster/bin/clquorumserver stop +
Example 6-12 Stopping a Specific Quorum Server
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.
Users other than the root role require solaris.cluster.read role-based access control (RBAC) authorization. For more information about RBAC rights profiles, see the rbac(5) man page.
# /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.
Example 6-13 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-14 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-15 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 +
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.
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.
# 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.
Example 6-16 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