Maintaining Quorum Devices

Language:

This section provides the following procedures for maintaining quorum devices:

How to Modify a Quorum Device Node List

You can use the clsetup utility to add a node to or remove a node from the node list of an existing quorum device. To modify a quorum device's node list, you must remove the quorum device, modify the physical connections of nodes to the quorum device you removed, then add the quorum device to the cluster configuration again. When a quorum device is added, the clquorum command automatically configures the node-to-disk paths for all nodes attached to the disk. For more information, see the clquorum(1CL) man page.

The phys-schost# prompt reflects a global-cluster prompt. Perform this procedure on a global cluster.

This procedure provides the long forms of the Oracle Solaris Cluster commands. Most commands also have short forms. Except for the long and short forms of the command names, the commands are identical.

Assume a role that provides solaris.cluster.modify authorization on any node of the cluster.

Determine the name of the quorum device you are modifying.
```
# clquorum list -v
```

Start the clsetup utility.
```
# clsetup
```
The Main Menu is displayed.

Type the number for the Quorum option.
The Quorum Menu is displayed.

Type the number for the option to remove a quorum device.
Follow the instructions. You will be asked the name of the disk to be removed.

Add or delete the node connections to the quorum device.

Type the number for the option to add a quorum device.
Follow the instructions. You will be asked the name of the disk to be used as the quorum device.

Verify that the quorum device has been added.
```
# clquorum list -v
```

How to Put a Quorum Device Into Maintenance State

Use the clquorum command to put a quorum device into a maintenance state. For more information, see the clquorum(1CL) man page. The clsetup utility does not currently have this capability.

Put a quorum device into a maintenance state when taking the quorum device out of service for an extended period of time. This way, the quorum device's quorum vote count is set to zero and does not contribute to the quorum count while the device is being serviced. While in maintenance state, the quorum device's configuration information is preserved.

Note - All two-node clusters require at least one configured quorum device. If this is the last quorum device on a two-node cluster, clquorum will fail to put the device into maintenance state.

To put a cluster node into maintenance state, see How to Put a Node Into Maintenance State.

The phys-schost# prompt reflects a global-cluster prompt. Perform this procedure on a global cluster.

Note - You can also use the Oracle Solaris Cluster Manager browser interface to disable a quorum device to put it into a maintenance state. For Oracle Solaris Cluster Manager log-in instructions, see How to Access Oracle Solaris Cluster Manager.

If your cluster is in installation mode, click Reset Quorum Devices to exit installation mode.

Assume a role that provides solaris.cluster.modify authorization on any node of the cluster.

Put the quorum device into the maintenance state.
```
# clquorum disable device
```
device

Specifies the DID name of the disk device to change, for example, d4.

Verify that the quorum device is now in maintenance state.
The output for the device you placed in maintenance state should read zero for the Quorum Device Votes.
```
# clquorum status device
```

Example 59 Putting a Quorum Device Into Maintenance State

The following example shows how to put a quorum device into maintenance state and how to verify the results.

# clquorum disable d20
# clquorum status d20
 
=== Cluster Quorum ===

--- Quorum Votes by Device ---

Device Name       Present      Possible      Status
-----------       -------      --------      ------
d20               1            1             Offline

See Also

To re-enable the quorum device, see How to Bring a Quorum Device Out of Maintenance State.

To put a node into maintenance state, see How to Put a Node Into Maintenance State.

How to Bring a Quorum Device Out of Maintenance State

Run this procedure each time a quorum device is in a maintenance state and you want to bring the quorum device out of maintenance state and reset the quorum vote count to the default.

Caution - If you do not specify either the globaldev or node options, the quorum count is reset for the entire cluster.

When you configure a quorum device, Oracle Solaris Cluster software assigns the quorum device a vote count of N-1 where N is the number of connected votes to the quorum device. For example, a quorum device that is connected to two nodes with nonzero vote counts has a quorum count of one (two minus one).

To bring a cluster node as well as its associated quorum devices out of maintenance state, see How to Bring a Node Out of Maintenance State.
To learn more about quorum vote counts, see About Quorum Vote Counts in Oracle Solaris Cluster 4.3 Concepts Guide.

Note - You can also use the Oracle Solaris Cluster Manager browser interface to enable a quorum device to bring it out of a maintenance state. For Oracle Solaris Cluster Manager log-in instructions, see How to Access Oracle Solaris Cluster Manager.

The phys-schost# prompt reflects a global-cluster prompt. Perform this procedure on a global cluster.

Assume a role that provides solaris.cluster.modify authorization on any node of the cluster.

Reset the quorum count.
```
# clquorum enable device
```
device

Specifies the DID name of the quorum device to reset, for example, d4.

If you are resetting the quorum count because a node was in maintenance state, reboot the node.

Verify the quorum vote count.
```
# clquorum show +
```

Example 60 Resetting the Quorum Vote Count (Quorum Device)

The following example resets the quorum count for a quorum device back to the default and verifies the result.

# clquorum enable d20
# clquorum show +

=== Cluster Nodes ===

Node Name:                                      phys-schost-2
Node ID:                                        1
Quorum Vote Count:                              1
Reservation Key:                                0x43BAC41300000001

Node Name:                                      phys-schost-3
Node ID:                                        2
Quorum Vote Count:                              1
Reservation Key:                                0x43BAC41300000002


=== Quorum Devices ===

Quorum Device Name:                             d3
Enabled:                                        yes
Votes:                                          1
Global Name:                                    /dev/did/rdsk/d20s2
Type:                                           shared_disk
Access Mode:                                    scsi3
Hosts (enabled):                                phys-schost-2, phys-schost-3

How to List the Quorum Configuration

You do not need to be in the root role to list the quorum configuration. You can assume any role that provides solaris.cluster.read authorization.

Note - When you increase or decrease the number of node attachments to a quorum device, the quorum vote count is not automatically recalculated. You can reestablish the correct quorum vote if you remove all quorum devices and then add them back into the configuration. For a two-node cluster, temporarily add a new quorum device before you remove and add back the original quorum device. Then remove the temporary quorum device.

The phys-schost# prompt reflects a global-cluster prompt. Perform this procedure on a global cluster.

Note - You can also use the Oracle Solaris Cluster Manager browser interface to view the quorum configuration. For Oracle Solaris Cluster Manager log-in instructions, see How to Access Oracle Solaris Cluster Manager.

Use the clquorum command to list the quorum configuration.
```
% clquorum show +
```

Example 61 Listing the Quorum Configuration

% clquorum show +

=== Cluster Nodes ===

Node Name:                                      phys-schost-2
Node ID:                                        1
Quorum Vote Count:                              1
Reservation Key:                                0x43BAC41300000001

Node Name:                                      phys-schost-3
Node ID:                                        2
Quorum Vote Count:                              1
Reservation Key:                                0x43BAC41300000002


=== Quorum Devices ===

Quorum Device Name:                             d3
Enabled:                                        yes
Votes:                                          1
Global Name:                                    /dev/did/rdsk/d20s2
Type:                                           shared_disk
Access Mode:                                    scsi3
Hosts (enabled):                                phys-schost-2, phys-schost-3

How to Repair a Quorum Device

Use this procedure to replace a malfunctioning quorum device.

The phys-schost# prompt reflects a global-cluster prompt. Perform this procedure on a global cluster.

Remove the disk device that you are replacing as a quorum device.
Note - If the device you intend to remove is the last quorum device, you might want to first add another disk as a new quorum device. This step assures a valid quorum device if a failure occurs during the replacement procedure. See Adding a Quorum Device to add a new quorum device.

See How to Remove a Quorum Device to remove a disk device as a quorum device.
Replace the disk device.
To replace the disk device, see the procedures for the disk enclosure in the hardware guide. See also the Oracle Solaris Cluster Hardware Administration Manual.
Add the replaced disk as a new quorum device.
See Adding a Quorum Device to add a disk as a new quorum device.

Note - If you added an additional quorum device in Step 1, it is now safe to remove it. See How to Remove a Quorum Device to remove the quorum device.