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
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.