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.

Note: This command is available during the upgrade 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.