4.1.6 How to Put a Cluster Node Into Maintenance State

Put a cluster node into maintenance state when taking the node out of service for an extended period of time. This way, the node does not contribute to the quorum count while it is being serviced. To put a cluster node into maintenance state, the node must be brought down using scswitch(1M) and shutdown(1M).

Use the Solaris shutdown command to shut down a single node. The scshutdown command should be used only when shutting down an entire cluster.

When a cluster node is brought down and put into maintenance state, all quorum devices that are configured with ports to the node have their quorum vote counts decremented by one. The node and quorum device vote counts are incremented by one when the node is taken out of maintenance mode and brought back online.

You need to use scconf(1M) to put a cluster node into the maintenance state.The scsetup utility does not have the ability to put a quorum device into maintenance state.

1. Become superuser on the node to be put into maintenance state.

2. On the node to be put into maintenance state, use scswitch to evacuate any resource groups and disk device groups from the node and then shutdown to bring it down and out of the cluster.

   phys-schost-1# scswitch -S -h node phys-schost-1# shutdown -g 0 -y

3. Become superuser on another node and put the node brought down in Step 2 into the maintenance state.

   phys-schost-2# scconf -c -q node=node,maintstate

   -c

   Specifies the change form of the scconf command.

   -q

   Manages the quorum options.

   node=node

   Specifies the node name or node ID of the node to change.

   maintstate

   Puts the node into maintenance state.

4. Verify that the cluster node is now in maintenance state.

   phys-schost-2# scconf -p | grep -i vote

4.1.6.1 Example--Putting a Cluster Node Into Maintenance State

The following example moves a cluster node into maintenance state and verifies the results.

phys-schost-1# scswitch -S -h phys-schost-1
phys-schost-1# shutdown -g 0 -y
phys-schost-2# scconf -c -q node=phys-schost-1,maintstate
phys-schost-2# scconf -p | grep -i quorum
 Node quorum vote count:                           1
Quorum devices:                                    d20
Quorum device name:                                d20
  Quorum device votes:                             1
  Quorum device enabled:                           yes
  Quorum device path:                              /dev/did/rdsk/d5s2
  Quorum device hosts (disabled):                 phys-schost-1
  Quorum device hosts (enabled):                  phys-schost-2

4.1.6.2 Where to Go From Here

When you have completed the maintenance procedures, see "4.1.7 How to Bring a Node Out of Maintenance State and Reset Quorum" to reset the quorum vote back to the default.