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:
- 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.
- Stop all FlashCopy, Metro Mirror, Global
Mirror, and data migration operations.
- 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.