How to Put a Quorum Device Into Maintenance State
Use the scconf(1M) command to put a quorum device into maintenance state. The scsetup(1M) utility does not currently have this capability. You can also accomplish this procedure by using the SunPlex Manager GUI. See the SunPlex Manager online help for more information.
Put a quorum device into maintenance state when taking the quorum device out of service for an extended period of time. This way, the disk 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, scconf 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.
Become superuser on any node of the cluster.
Put the quorum device into the maintenance state.
# scconf -c -q globaldev=device,maintstate
-c Specifies the change form of the scconf command.
-q Manages the quorum options.
globaldev=device Specifies the DID name of the disk device to change, for example, d4.
maintstate Puts the shared quorum device into maintenance state.
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.
# scconf -p | grep -i quorum
Example--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.
# scconf -c -q globaldev=d20,maintstate # scconf -p | grep -i quorum Node quorum vote count: 1 Node quorum vote count: 1 Quorum devices: d20 Quorum device name: d20 Quorum device votes: 0 Quorum device enabled: no Quorum device name: /dev/did/rdsk/d20s2 Quorum device hosts (enabled): phys-schost-2 phys-schost-3 Quorum device hosts (disabled): |
Where to Go From Here
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
After a quorum device has been in maintenance state, and is being brought back online, use the following procedure to reset the quorum vote count to the default. For cluster nodes, the default quorum count is one. For quorum devices, the default quorum count is N-1, where N is the number of nodes with non-zero vote counts that have ports to the quorum device.
You should run this procedure any time a quorum device has been put into maintenance state and you are bringing it out of maintenance state.
Caution - If you do not specify either the globaldev
or node options, the quorum count is reset for the entire
cluster.
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.
Become superuser on any node of the cluster.
Reset the quorum count.
# scconf -c -q globaldev=device,reset
-c Specifies the change form of the scconf command.
-q Manages the quorum options.
globaldev=device Specifies the DID name of the quorum device to reset, for example, d4.
reset The change flag that resets quorum.
If you are resetting the quorum count because a node was in maintenance state, reboot the node.
Verify the quorum vote count.
# scconf -p | grep -i quorum
Example--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.
# scconf -c -q globaldev=d20,reset # scconf -p | grep -i quorum Node quorum vote count: 1 Node quorum vote count: 1 Quorum devices: d20 Quorum device name: d20 Quorum device votes: 1 Quorum device enabled: yes Quorum device name: /dev/did/rdsk/d20s2 Quorum device hosts (enabled): phys-schost-2 phys-schost-3 Quorum device hosts (disabled): |
How to List the Quorum Configuration
You can also accomplish this procedure by using the SunPlex Manager GUI. See the SunPlex Manager online help for more information.
You do not need to be superuser to list the quorum configuration.
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.
Example--Listing the Quorum Configuration
# scconf -p | grep "Quorum | vote" Node quorum vote count: 1 Node quorum vote count: 1 Quorum devices: d20 Quorum device name: d20 Quorum device votes: 1 Quorum device enabled: yes Quorum device name: /dev/did/rdsk/d20s2 Quorum device hosts (enabled): phys-schost-2 phys-schost-3 Quorum device hosts (disabled): |