README for ndmpcopy
$Id: //depot/tools/main/ndmptools/ndmpcopy-1.2/README#1 $

Ndmpcopy transfers data between filers using the Network Data
Management Protocol (NDMP).  When you use rsh to perform this transfer,
the data flows from the source machine to the rsh host and then again
from the rsh host to the destination machine.  This can put a double
load on the network and unneccessary load on the rsh host.  With
ndmpcopy, data is transferred directly from the source machine to the
destination machine, and the NDMP host and network are not burdoned
with the extra load.

When you run ndmpcopy it will contact the NDMP server processes on
the source and destination machines and authenticate the connection.
It will then initiate a backup on the source machine and a restore
on the destination machine.  The transfer will happen between the
two machines directly, only burdoning the NDMP host with status
messages instead of all of the backup data.  Initial tests have
demonstrated double the performance when using ndmpcopy instead
of rsh.

COMPATIBILITY NOTE:

Because of limitations in the NDMP protocol, this program depends on
certain extensions that are not part of the NDMP specification.  These
extensions are available in Network Appliance filers running kernel
revision 4.2 or higher.  A detailed description of the modifications
required are described in the file CHANGES.PROTOCOL.

To use ndmpcopy with incremental dump and restore, the NetApp filer
that is the destination is required to run DATA ONTAP revision 4.3
or higher.

INSTALLATION

To install ndmpcopy, first download it from the NDMP website at
www.ndmp.org or the NDMP ftp site at ftp.ndmp.org.  Uncompress and
extract the source files using tar.

Change directory to ndmpcopy, then build ndmpcopy by typing "make".
This builds the NDMP library routines and the ndmpcopy executable.

Ndmpcopy has been tested under Solaris 2.5.1.  If you have ported this
to another operating system, please mail ndmp-tech@ndmp.org with patches.

For Linux, uncomment the line in ./src/Makefile regarding the linux flags.
