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.