Skip to main content
A newer release of this product is available.

storage failover show-takeover

Contributors
Suggest changes

Display takeover status

Availability: This command is available to cluster administrators at the admin privilege level.

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.

    You can specify additional parameters to display only the information that matches those parameters. For example, to display information only about a particular node, run the command with the `-node```_node_name_`` parameter.

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
ode       Node Status           Aggregate      Takeover Status
--------- --------------------- -------------- -------------------------------
odeA      Partner has
       relocated its
       aggregates. Takeover
       in progress.
                       aggr1          Done
                  aggr2          Done
                  CFO aggregates In progress.
odeB      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
ode       Node Status           Aggregate      Takeover Status
--------- --------------------- -------------- -------------------------------
odeA      Partner has
       relocated its
       aggregates. In
       takeover.
                     aggr1          Done
                  aggr2          Done
                  CFO aggregates Done.
arning: 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
ode       Node Status           Aggregate      Takeover Status
--------- --------------------- -------------- -------------------------------
odeA      Optimized takeover
       of partner aborted.
       Run the command
       "storage failover
       show-takeover -node
       nodeB" to display the
       relocation status of
       the partner.
              -              -
odeB      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.