Manual Pages


Table of Contents

NAME

na_partner - Accesses the data on the partner in takeover mode.

SYNOPSIS

partner [ command ]

DESCRIPTION

When one node in a High Availability (HA) pair fails, the other node takes over. To execute a Data ONTAP command on the failed node, use the partner command on the console of the node that took over. When a node executes a command on behalf of its partner, the node is said to be in ``partner mode.''

If the node is currently not in partner mode, the partner command without arguments causes the node to enter partner mode. After the node enters partner mode, the node executes each subsequent command on behalf of the partner until you enter the partner command again.

Alternatively, you can type partner followed by a command. The node enters partner mode and executes that command on behalf of the partner. After the node finishes executing the command, it exits partner mode.

In partner mode, you can enter any Data ONTAP command to manage the failed node, except that you cannot perform the following tasks:

  Halt or reboot the failed node.
  Set the date on the failed node.
  Synchronize the date on the failed node with a time server.
  Set the time zone on the failed node.
  Set vfiler limit (only available if multistore is licensed).
  Initiate a giveback or takeover.
  Revert the Data ONTAP(tm) software version to an earlier version.

When in partner mode, the node changes the console prompt to display the host name of the failed node, followed by a slash and the host name of the live node.

After a node in an HA pair fails, it stops running the telnet daemon. As a result, you cannot establish a telnet session with the failed node. You can, however, establish a telnet session to the node that has taken over, and enter the partner command as you would on the console.

EXAMPLES

Suppose an HA pair contains two nodes named toaster1 and toaster2. After toaster2 fails, toaster1 takes over. Because you can no longer enter commands on the console of toaster2, you must use the partner command on toaster1 to access toaster2. For example, to determine the maximum number of files on toaster2, enter the following command on toaster1:

  toaster1(takeover)> partner maxfiles
  Volume vol0: maximum number of files is currently 241954 (3194 used).
  Volume vol1: maximum number of files is currently 241954 (3195 used).
  toaster1(takeover)>

The following example illustrates how the console prompt on toaster1 changes after you enter the partner command on toaster1. The example also shows how to exit partner mode:

  toaster1(takeover)> partner
  toaster2/toaster1> maxfiles
  Volume vol0: maximum number of files is currently 241954 (3194 used).
  Volume vol1: maximum number of files is currently 241954 (3195 used).
  toaster2/toaster1> partner
  toaster1(takeover)>

The following example shows that the partner command toggles between the consoles of two nodes in an HA pair:

  toaster1(takeover)> partner partner
  toaster1(takeover)>

In this example, the first partner command causes toaster1 to execute the second partner command on toaster2, which returns you to toaster1's console. Consequently, the usual console prompt of toaster1 is displayed.


Table of Contents