logo

Manual Pages

Table of Contents

NAME

partner - access the data on the partner in takeover mode

SYNOPSIS

partner [ command ]

DESCRIPTION

When one filer in a cluster fails, the other filer takes over. To execute a Data ONTAP command on the failed filer, use the partner command on the console of the filer that took over. When a filer executes a command on behalf of its partner, the filer is said to be in ``partner mode.''

If the filer is currently not in partner mode, the partner command without arguments causes the filer to enter partner mode. After the filer enters partner mode, the filer 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 filer enters partner mode and executes that command on behalf of the partner. After the filer finishes executing the command, it exits partner mode.

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

Halt or reboot the failed filer.

Set the date on the failed filer.

Synchronize the date on the failed filer with a time server.

Set the time zone on the failed filer.

Initiate a giveback or takeover.

Revert the Data ONTAP(tm) software version to an earlier version.

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

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

EXAMPLES

Suppose a cluster contains two filers 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 filers in a cluster: 

  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