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 -reboot [ -force ] [ -node { node_name | node_id } ]
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.
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.