stopsystem

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

Syntax

Read syntax diagramSkip visual syntax diagram stopsystem -force-nodenode_namenode_id-reset-enterservicestate

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.
-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 system.
  • 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 system is shut down.
-reset
(Optional) Soft-resets a specified node. Must be used with -node node_id/node_name.
-enterservicestate
(Optional) Puts the specified node into service state.

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 need to shut down the system or a single node, use this command instead of removing the power to the node or node canister, 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® 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.

Check the Status LEDs on the node to ensure it has shutdown completely before moving the hardware.

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.