svctask stopsystem

Edit online

Use the svctask 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

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.

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.

Attention: Do not power off the uninterruptible power supply or remove the power cable from the node.

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.

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.