stopsystem

Use the stopsystem command to shut down a single node or the entire clustered system in a controlled manner. When you issue this command, you are prompted with a confirmation of intent to process the command.

Syntax

stopsystem [ -force ] [ -node { node_name | node_id } [ -reset ] ]

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 volumes 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 volumes going offline, you force the node to shut down, even if it is the last online node in the I/O group.
Remember: The -force parameter should always be used with caution.
-nodenode_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 system.
  • The node ID that is assigned to the node (not the worldwide node name).
If you specify -nodenode_name | node_id, only the specified node is shut down; otherwise, the entire system is shut down.
-reset
(Optional) Soft-resets a specified node. Must be used with -node node_id/node_name.

Description

Use this command to shut down a single node or the entire clustered system in a controlled manner. You are prompted with a confirmation of intent (to process the command) when you specify this command.

If you enter this command with no parameters, the entire system is shut down. All data is flushed to disk before the power is removed.

If you enter this command with either a node ID or node name, the specified node 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 system.

Entering y or 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.

If you need to shut down the system or a single node, use this command instead of using the power button on power supplies, or powering off the main power supplies to the system.

Before shutting down a node or system, complete the following requirements:
  1. Quiesce all I/O operations that are destined for this node or system. If you do not quiesce these, failed I/O operations might be reported to your host operating systems.
  2. Stop all FlashCopy, Metro Mirror, Global Mirror, and data migration operations.
  3. Ensure that all asynchronous deletion operations have completed.

Using this command to shut down a single node fails if shutting down the node makes any volumes inaccessible, or if it is the last node in an I/O group. If you still need to shut down the node, you can use the -force option to override these checks.

Important: You can specify stopsystem -node -reset to restart the I/O process.

An invocation example

stopsystem

The following confirmation prompt is displayed:

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

Select yes to confirm or no to cancel.

An invocation example

stopsystem -node 3

The following confirmation prompt is displayed:

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

Select yes to confirm or no to cancel.