6.1.7 How to Put a 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 the scconf(1M) command to put a cluster node into maintenance state.The scsetup utility does not include the functionality for putting a quorum device into maintenance state.

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

2. Evacuate any resource groups and disk device groups from the node.

   # scswitch -S -h nodelist

   -S

   Evacuates all device services and resource groups from the specified node.

   -h nodelist

   Specifies the node from which you are switching resource groups and devices groups.

3. Bring the node you evacuated down to the OBP prompt and out of the cluster.

   # shutdown -g0 -y -i0

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

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

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

   # scconf -p | grep -i vote

6.1.7.1 Example--Putting a Cluster Node Into Maintenance State

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

[On the node to be put into maintenance state:]
phys-schost-1# scswitch -S -h phys-schost-1
phys-schost-1# shutdown -g0 -y -i0

[On another node in the cluster:]
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

6.1.7.2 Where to Go From Here

To bring a node back online, see "6.1.8 How to Bring a Node Out of Maintenance State".