README for ndmpcopy
$Id: README,v 1.1 1997/08/14 17:16:30 boggs Exp $

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.

INSTALLATION

To install ndmpcopy, first download it from the NDMP website at
www.ndmp.org.   Uncompress and extract the source files into the
top of the directory tree.  If you are downloading ndmpcopy as
part of the NDMP Software Development Kit (SDK), change into the
subdirectory "ndmpkit-2.6/examples/ndmpcopy-1.0".  If you downloaded
ndmpcopy without the rest of the SDK, change to the directory
"ndmpcopy-1.0".

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.

