JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris Cluster System Administration Guide     Oracle Solaris Cluster 4.1
search filter icon
search icon

Document Information

Preface

1.  Introduction to Administering Oracle Solaris Cluster

2.  Oracle Solaris Cluster and RBAC

3.  Shutting Down and Booting a Cluster

4.  Data Replication Approaches

5.  Administering Global Devices, Disk-Path Monitoring, and Cluster File Systems

6.  Administering Quorum

Administering Quorum Devices

Dynamic Reconfiguration With Quorum Devices

Adding a Quorum Device

How to Add a Shared Disk Quorum Device

How to Add a Sun ZFS Storage Appliance NAS Quorum Device

How to Add a Quorum Server Quorum Device

Removing or Replacing a Quorum Device

How to Remove a Quorum Device

How to Remove the Last Quorum Device From a Cluster

How to Replace a Quorum Device

Maintaining Quorum Devices

How to Modify a Quorum Device Node List

How to Put a Quorum Device Into Maintenance State

How to Bring a Quorum Device Out of Maintenance State

How to List the Quorum Configuration

How to Repair a Quorum Device

Changing the Quorum's Default Time-out

Administering Oracle Solaris Cluster Quorum Servers

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

How to Display Information About the Quorum Server

Cleaning Up Stale Quorum Server Cluster Information

How to Clean Up the Quorum Server Configuration Information

7.  Administering Cluster Interconnects and Public Networks

8.  Adding and Removing a Node

9.  Administering the Cluster

10.  Configuring Control of CPU Usage

11.  Updating Your Software

12.  Backing Up and Restoring a Cluster

A.  Example

Index

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:

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.

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

How to Start a Quorum Server

  1. Assume the root role 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-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

How to Stop a Quorum Server

  1. Assume the root role 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-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

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. Assume the root role on the host where you want to display the quorum server information.

    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.

  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-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 +

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:


Caution

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

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


  1. Assume the root role 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-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