This section provides the following procedures for maintaining quorum devices:
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.
# clquorum list -v
# clsetup
The Main Menu is displayed.
The Quorum Menu is displayed.
Follow the instructions. You will be asked the name of the disk to be removed.
Follow the instructions. You will be asked the name of the disk to be used as the quorum device.
# clquorum list -v
The following example shows how to use the clsetup utility to add nodes to or delete nodes from a quorum device node list. In this example, the quorum device name is d2, and the final result of the procedures adds another node to the quorum device node list.
[Assume the root role that provides solaris.cluster.modify RBAC authorization on any node in the cluster.] [Determine the quorum device name:] # clquorum list -v Quorum Type ------- ----- d2 shared_disk sc-phys-schost-1 node sc-phys-schost-2 node sc-phys-schost-3 node [Start the clsetup utility:] # clsetup [Type the number that corresponds with the quorum option.] . [Type the number that corresponds with the option to remove a quorum device.] . [Answer the questions when prompted.] [You will need the following information:] Information: Example: Quorum Device Name: d2 [Verify that the clquorum command completed successfully:] clquorum remove d2 Command completed successfully. [Verify that the quorum device was removed.] # clquorum list -v Quorum Type ------- ----- sc-phys-schost-1 node sc-phys-schost-2 node sc-phys-schost-3 node [Type the number that corresponds with the Quorum option.] . [Type the number that corresponds with the option to add a quorum device.] . [Answer the questions when prompted.] [You will need the following information:] Information Example: quorum device name d2 [Verify that the clquorum command was completed successfully:] clquorum add d2 Command completed successfully. Quit the clsetup utility. [Verify that the correct nodes have paths to the quorum device. In this example, note that phys-schost-3 has been added to the enabled hosts list.] # clquorum show d2 | grep Hosts === Quorum Devices === Quorum Device Name: d2 Hosts (enabled): phys-schost-1, phys-schost-2, phys-schost-3 [Verify that the modified quorum device is online.] # clquorum status d2 === Cluster Quorum === --- Quorum Votes by Device --- Device Name Present Possible Status ----------- ------- -------- ------ d2 1 1 Online
Use theclquorum 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.
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.
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.
You can also use the Oracle Solaris Cluster Manager GUI to disable a quorum device to put it into a maintenance state. For 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.
# clquorum disable device
Specifies the DID name of the disk device to change, for example, d4.
The output for the device you placed in maintenance state should read zero for the Quorum Device Votes.
# clquorum status device
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.
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 Concepts Guide .
You can also use the Oracle Solaris Cluster Manager GUI to enable a quorum device to bring it out of a maintenance state. For 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.
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.
# clquorum enable device
Specifies the DID name of the quorum device to reset, for example, d4.
# clquorum show +
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
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 RBAC authorization.
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.
You can also use the Oracle Solaris Cluster Manager GUI to view the quorum configuration. For GUI log-in instructions, see How to Access Oracle Solaris Cluster Manager.
Example 6-8 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
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.
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.
See How to Remove a Quorum Device to remove a disk device as a quorum device.
To replace the disk device, see the procedures for the disk enclosure in the hardware guide. See also the Oracle Solaris Cluster 4.2 Hardware Administration Manual .
See Adding a Quorum Device to add a disk as a new quorum device.