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(1M) utility does not include the functionality for putting a quorum device into maintenance state.

Steps

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 node[,...]

   -S

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

   -h node[,...]

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

3. Shut down the node that you evacuated.

   # shutdown -g0 -y -i0

4. Become superuser on another node in the cluster and put the node that you shut 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.

   # scstat -q

   The node you put into maintenance state should have a Status of offline and 0 (zero) for Present and Possible quorum votes.

Example 7–9 Putting a Cluster Node Into Maintenance State

The following example moves a cluster node into maintenance state and verifies the results. The scstat -q output shows the Node votes for phys-schost-1 to be 0 (zero) and the status to be Offline. The Quorum Summary should also show reduced vote counts. Depending on your configuration, the Quorum Votes by Device output might indicate that some quorum disk devices are offline as well.

[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# scstat -q

-- Quorum Summary --
  Quorum votes possible:      3
  Quorum votes needed:        2
  Quorum votes present:       3

-- Quorum Votes by Node --
                    Node Name           Present Possible Status
                    ---------           ------- -------- ------
  Node votes:       phys-schost-1       0        0       Offline
  Node votes:       phys-schost-2       1        1       Online
  Node votes:       phys-schost-3       1        1       Online

-- Quorum Votes by Device --
                    Device Name         Present Possible Status
                    -----------         ------- -------- ------
  Device votes:     /dev/did/rdsk/d3s2  0        0       Offline
  Device votes:     /dev/did/rdsk/d17s2 0        0       Offline
  Device votes:     /dev/did/rdsk/d31s2 1        1       Online

See Also

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