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 shut down by using clnode(1CL) evacuate and cluster(1CL) shutdown commands.

Use the Solaris shutdown command to shut down a single node. Use the cluster shutdown command only when shutting down an entire cluster.

When a cluster node is shut down and put in 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 removed from maintenance mode and brought back online.

Use the clquorum(1CL) disable command to put a cluster node to maintenance state.

This procedure provides the long forms of the Sun Cluster commands. Most commands also have short forms. Except for the long and short forms of the command names, the commands are identical. For a list of the commands and their short forms, see Appendix A, Sun Cluster Object-Oriented Commands.

1. Become superuser or assume a role that provides solaris.cluster.modify RBAC authorization on the node that you are putting into maintenance state.

2. Evacuate any resource groups and device groups from the node. The clnode evacuate command switches over all resource groups and device groups, including all non-global zones from the specified node to the next preferred node.

   # clnode evacuate node

3. Shut down the node that you evacuated.

   # shutdown -g0 -y-i 0

4. Become superuser or assume a role that provides solaris.cluster.modify RBAC authorization on another node in the cluster and put the node that you shut down in Step 3 in maintenance state.

   # clquorum disable type [node]

   type

   Specifies the quorum device type. The type can be node, scsi, netapp_nas, or quorum_server.

   node

   Specifies the name of a node you want to put into maintenance mode.

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

   # clquorum status -t node

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

Example 8–9 Putting a Cluster Node In Maintenance State

The following example puts a cluster node in maintenance state and verifies the results. The clnode status 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# clnode evacute phys-schost-1
phys-schost-1# shutdown -g0 -y -i0

[On another node in the cluster:]
phys-schost-2# clquorum disable -t node phys-schost-1
phys-schost-2# clquorum status -t node

-- Quorum Votes by Node --

Node Name           Present       Possible       Status
---------           -------       --------       ------
phys-schost-1       0             0              Offline
phys-schost-2       1             1              Online
phys-schost-3       1             1              Online

See Also

To bring a node back online, see How to Remove Node From Maintenance State.