storage failover show-takeover
Display takeover status
Description
The storage failover show-takeover command displays information about the takeover status of nodes in a cluster. The command also displays the takeover status of aggregates being taken over. During each phase of takeover, the takeover node and the node being taken over display their takeover status and the status of the aggregates being taken over. The command displays the following information when no parameters are specified:
- Node name
- Node takeover status - This contains a descriptive information about the phase of takeover.
- Aggregate
- Aggregate takeover status - This contains the following information:
- Takeover status of the aggregate, such as "Done", "Failed", "In progress" and "Not attempted yet".
- Reason for an aggregate takeover failure.
- Corrective action, in case of an aggregate takeover failure.
Parameters
- { [-fields <fieldname>, ...]
- If this parameter is specified, the command displays the specified fields for all nodes, in column style output.
- | [-instance ]}
- If this parameter is specified, the command displays the same detailed information as for the -node parameter, but for all nodes.
- [-node {<nodename>|local}] - Node Name
- If this parameter is specified, the command displays information about the takeover status of the specified node, and the takeover status of the aggregates being taken over.
- [-node-takeover-status <text>] - Node's Takeover Status
- If this parameter is specified, the command displays information about the takeover status of the nodes with the specified node-takeover-status. The command also displays the takeover status of the aggregates belonging to the node being taken over.
- [-aggregate <text>] - Aggregate Being Taken Over
- If this parameter is specified, the command displays information about the takeover status of the specified aggregate, and the takeover status of the nodes containing the specified aggregate.
- [-aggregate-takeover-status <text>] - Aggregate's Takeover Status
- If this parameter is specified, the command displays information about the takeover status of the aggregates with the specified aggregate takeover status, and the takeover status of the nodes containing those aggregates.
Examples
The following example shows the takeover status of two nodes, nodeA and nodeB, in an High Availability (HA) pair, when both are in normal mode; neither node has taken over its HA partner. In this case, there is no takeover status for the aggregates.
cluster1::> storage failover show-takeover
Node Node Status Aggregate Takeover Status
---------- --------------------- -------------- -------------------------------
nodeA Takeover not
attempted.
- -
nodeB Takeover not
attempted.
- -
The following example shows the takeover status of two nodes, nodeA and nodeB, in an HA pair, when nodeA is in the SFO phase of an optimized takeover of nodeB. In this case, nodeA does not have information about the takeover status of nodeB's aggregates.
cluster1::> storage failover show-takeover
Node Node Status Aggregate Takeover Status
---------- --------------------- -------------- -------------------------------
nodeA Optimized takeover
of partner in
progress. Partner,
("nodeB"), is
relocating its SFO
aggregates. Run the
command "storage
failover
show-takeover -node
nodeB" to display the
relocation status of
the partner.
- -
nodeB Being taken over.
aggr1 In progress, Module: backup.
aggr2 Not attempted yet
CFO aggregates Not attempted yet.
The following example shows the takeover status of two nodes, nodeA and nodeB, in an HA pair, when nodeA has completed the SFO phase of an optimized takeover of nodeB (but has not completed the CFO phase of the optimized takeover). In this case, nodeA has information about the takeover status of nodeB's aggregates.
cluster1::> storage failover show-takeover
Node Node Status Aggregate Takeover Status
---------- --------------------- -------------- -------------------------------
nodeA Partner has
relocated its
aggregates. Takeover
in progress.
aggr1 Done
aggr2 Done
CFO aggregates In progress.
nodeB Relocated aggregates
to partner. Waiting
for partner to
takeover.
aggr1 Done
aggr2 Done
CFO aggregates Not attempted yet.
The following example shows the takeover status of two nodes, nodeA and nodeB, in an HA pair, when nodeA has completed the SFO and CFO phases of an optimized takeover of nodeB. In this case, nodeA has information about the takeover status of nodeB's aggregates. Since nodeB is not operational, an Remote Procedure Call(RPC) error is indicated in the command output.
cluster1::> storage failover show-takeover
Node Node Status Aggregate Takeover Status
---------- --------------------- -------------- -------------------------------
nodeA Partner has
relocated its
aggregates. In
takeover.
aggr1 Done
aggr2 Done
CFO aggregates Done.
Warning: Unable to list entries on node nodeB. RPC: Port mapper failure - RPC:
Timed out
The following example shows the takeover status of two nodes, nodeA and nodeB, in an HA pair, when nodeA has aborted the SFO phase of an optimized takeover of nodeB. In this case, nodeA does not have information about the takeover status of nodeB's aggregates.
cluster1::> storage failover show-takeover
Node Node Status Aggregate Takeover Status
---------- --------------------- -------------- -------------------------------
nodeA Optimized takeover
of partner aborted.
Run the command
"storage failover
show-takeover -node
nodeB" to display the
relocation status of
the partner.
- -
nodeB Optimized takeover
by partner aborted.
aggr1 Failed: Destination node did
not online the aggregate on
time. To takeover the
remaining aggregates, run the
"storage failover takeover
-ofnode nodeB
-bypass-optimization true"
command. To giveback the
relocated aggregates, run the
"storage failover giveback
-ofnode nodeB" command.
aggr2 Not attempted yet
CFO aggregates Not attempted yet.