ONTAP 9.12.1 commands

50←PDF
  • ONTAP 9.12.1 commands(CA08871-263en.pdf)
  • storage failover show-takeover

    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.
    Top of Page