Example--Changing the Private Hostname

The following example changes the private hostname from clusternode2-priv to clusternode4-priv, on node phys-schost-2.

[Disable all applications and data services as necessary.]
phys-schost-1# /etc/init.d/xntpd stop
phys-schost-1# scconf -p | grep node
 ...
 Cluster nodes:                  phys-schost-1 phys-schost-2 phys-
 schost-3
 Cluster node name:                                 phys-schost-1
  Node private hostname:                           clusternode1-priv
 Cluster node name:                                 phys-schost-2
  Node private hostname:                           clusternode2-priv
 Cluster node name:                                 phys-schost-3
  Node private hostname:                           clusternode3-priv
 ...
phys-schost-1# scsetup
phys-schost-1# nscd -i hosts
phys-schost-1# vi /etc/inet/ntp.conf
 ...
 peer clusternode1-priv
 peer clusternode4-priv
 peer clusternode3-priv
phys-schost-1# ping clusternode4-priv
phys-schost-1# /etc/init.d/xntpd start
[Enable all applications and data services disabled at the beginning of the procedure.]

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

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

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

Where to Go From Here

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

How to Bring a Node Out of Maintenance State

Use the following procedure to bring a node back online and 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.

When a node has been put into maintenance state, the node's quorum vote count is decremented by one. All quorum devices that are configured with ports to the node will also have their quorum vote counts decremented. When the quorum vote count is reset and a node is brought back out of maintenance state, both the node's quorum vote count and the quorum device vote count are incremented by one.

Run this procedure any time a node 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.

1. Become superuser on any node of the cluster, other than the one in maintenance state.

2. Are you bringing a node out of maintenance state in a two-node cluster?

   • If yes, go to Step 4.

   • If no, go to Step 3.

3. If using quorum, reset the cluster quorum count from a node other than the one in maintenance state.

   You must reset the quorum count from a node other than the node in maintenance state before rebooting the node, or it might hang waiting for quorum.

   # scconf -c -q node=node,reset

   
   

   -c	Specifies the change form of the scconf command.
   -q	Manages the quorum options.
   node=node	Specifies the name of the node to be reset, for example, phys-schost-1.
   reset	The change flag that resets quorum.

4. Boot the node that you want to bring out of maintenance state.

5. Verify the quorum vote count.

   # scstat -q

   
   

   The node you brought out of maintenance state should have a status of online and show the appropriate vote count for Present and Possible quorum votes.