stopcluster

The stopcluster command allows you to shut down a single node or the entire cluster in a controlled manner. When you issue this command, you are prompted with a confirmation of intent to process the command.

Syntax


>>- svctask -- -- stopcluster -- --+----------+-- -------------->
                                   '- -force -'      

>--+--------------------------+--------------------------------><
   '- -node --+- node_name -+-'   
              '- node_id ---'

Parameters

-force

(Optional) Specifies that the node that is being shut down is the last online node in a given I/O group. The force parameter also overrides the checks that this command runs. The parameter overrides the following two checks:

If the command results in VDisks going offline, the command fails unless the force parameter is used.
If the node being shut down is the last online node in the I/O group, the command fails unless the force parameter is used.

If you use the force parameter as a result of an error about VDisks going offline, you force the node shutdown even if it is the last online node in the I/O group. The force parameter should always be used with caution.

-node node_name | node_id

(Optional) Specifies the node that you want to shut down. You can specify one of the following values:

The node name, or label that you assigned when you added the node to the cluster
The node ID that is assigned to the node (not the worldwide node name).

If you specify -node node_name | node_id, only the specified node is shut down; otherwise, the entire cluster is shut down.

Description

When you enter this command with no parameters, the entire cluster is shutdown. All data is flushed to disk before the power is removed.

Attention: Ensure that you have stopped all FlashCopy®, Metro or Global Mirror, or data migration operations before you attempt to shutdown a node or cluster. You must also ensure that all asynchronous deletion operations have completed prior to a shutdown operation.

When you enter this command with either a node ID or node name, the node in question is shut down. After the command completes, the remaining node in the I/O group enters write-through mode until the power to the node is returned and the node rejoins the cluster.

Attention: If you have to remove all cluster input power for more than a few minutes, you must shut down the cluster before you remove the power. If the input power is removed from the uninterruptible power supply units without first shutting down the cluster and the uninterruptible power supply units, the uninterruptible power supply units remain operational and eventually become drained of power.

When input power is restored to the uninterruptible power supply units, they begin to recharge but the nodes do not permit I/O activity on the virtual disks until the uninterruptible power supply is charged enough to enable all the data on the nodes to be saved in the event of an unexpected power loss. This might take as long as two hours. Shutting down the cluster prior to removing input power to the uninterruptible power supply units prevents the draining of battery power and makes it possible for I/O activity to resume as soon as input power is restored.

Attention: Before shutting down a node or the cluster, quiesce all I/O operations that are destined for this node or cluster. Failure to quiesce can result in failed I/O operations being reported to your host operating systems.

Begin the process of quiescing all I/O to the cluster by stopping the applications on your hosts that are using the VDisks that are provided by the cluster. Perform the following steps to quiesce all I/O to the cluster:

If you are unsure which hosts are using the VDisks that are provided by the cluster, determine the hosts that the VDisks are mapped to, as follows:
1. List the hosts that this VDisk is mapped to by issuing the following command, substituting the vdiskname | id variable with the name or ID of the VDisk:
```
svcinfo lsvdiskhostmap vdiskname | id
```
2. In the command output, located the host name or ID to determine which host the specified VDisk is mapped to. If no data is displayed, the VDisk is not mapped to any hosts.
Repeat the previous procedure for all VDisks.

Attention: If you are shutting down the entire cluster, you lose access to all VDisks that are being provided by this cluster.

When all I/O has been stopped, issue the svctask stopcluster to shut down a single node or the entire cluster in a controller manner. If you specify the node ID or node name, you can shut down a single node. After the command completes, the other node in the I/O group goes into write-through mode until the power to the node is returned and the node rejoins the cluster.

Attention: If this is the last node in an I/O group, you must specify the -force parameter. You will lose all access to the virtual disks in the I/O group. Before you enter this command, ensure that this is what you want to do.

If a shutdown command has been sent to the cluster and both cluster and uninterruptible power supply units have powered off, when input power is restored, press the power button on the uninterruptible power supply front panel to restart the uninterruptible power supply units.

Ensure that you have stopped all FlashCopy mappings and Metro or Global Mirror relationships. In addition, ensure that all data migration operations and forced deletions have completed before continuing. Entering y to the confirmation message processes the command. No feedback is then displayed. Entering anything other than y or Y results in the command not processing. No feedback is displayed.

Attention: If you are shutting down a single node and the other node in the I/O group is online, the cache on the partner node goes into the write-through mode and that you are exposed to a single point of failure if the partner node fails while the node is shut down. You also lose access to all VDisks being served by this I/O group.

An invocation example

svctask stopcluster

The resulting output You will be presented with the following warning:

 Are you sure that you want to continue with the shut down?