Table of ContentsView in Frames

Copying data using ndmpcopy

You can run the ndmpcopy command at the command line of the source storage system, the destination storage system, or a storage system that is neither the source nor the destination of the data transfer. You can also run ndmpcopy on a single storage system that is both the source and the destination of the data transfer.

Step

  1. To copy data within a storage system or between storage systems using ndmpcopy, enter the following command:
    ndmpcopy [options][source_filer:]source_path [destination_filer:]destination_path [-mcs {inet|inet6}][-mcd {inet|inet6}][-md {inet|inet6}]

    • You can specify one or more options in the ndmpcopy command. The following table lists the available options:
      Option Description
      -sa username:[password] Source authorization that specifies the user name and password for connecting to the source storage system
      Note: For a user without root privilege, you must specify the user's system-generated NDMP-specific password and not the regular storage system account password.
      -da username:[password] Destination authorization that specifies the user name and password for connecting to the destination storage system
      -st {md5|text} Sets the source authentication type to be used when connecting to the source storage system
      Note: md5 is the default authentication type used. The md5 authentication exchanges the user name and password in encrypted form. The text authentication exchanges the user name and password in clear text.
      -dt {md5|text} Sets the destination authentication type to be used when connecting to the destination storage system
      -l Sets the dump level used for the transfer to the specified value of level

      Valid values for level are 0, 1, and 2, where 0 indicates a full transfer and 1 or 2 an incremental transfer. The default is 0.

      -d Enables generation of ndmpcopy debug log messages

      ndmpcopy debug log files appear in the root volume /etc/log directory. The ndmpcopy debug log file names are in the form ndmpcopy.yyyymmdd.

      -f Enables forced mode

      This mode enables overwriting system files in the /etc directory on the root volume.

      -h Prints the help message
      -p Prompts you to enter the password for source and destination authorization
      This password overrides the password specified for -sa and -da options.
      Note: You can use this option only when the command is running in an interactive console.
      -exclude Excludes specified files or directories from the path specified for data transfer

      The value can be a comma-separated list of directory or file names such as "*.pst" or "*.txt".

    • source_filer and destination_filer can be host names or IP addresses.
      The ndmpcopy command determines the address mode for control connections as follows:
      • When an IP address (IPv4 or IPv6) is specified instead of the host name, the addressing mode for the control connection is the corresponding IP address type.
      • When a host name is specified and it resolves to both IPv6 and IPv4 addresses, IPv6 addressing mode is used.
      You can override these rules by using the -mcs and -mcd options.
    • source_path and destination_path are the absolute path names of the directories to be used during the data transfer.
    • -mcs specifies the preferred addressing mode for the control connection to the source storage system.

      inet indicates an IPv4 address mode and inet6 indicates an IPv6 address mode.

    • -mcd specifies the preferred addressing mode for the control connection to the destination storage system.

      inet indicates an IPv4 address mode and inet6 indicates an IPv6 address mode.

    • -md specifies the preferred addressing mode for communication between the source and the destination storage systems.

      inet indicates an IPv4 address mode and inet6 indicates an IPv6 address mode.

      If you do not use the -md option in the ndmpcopy command, the addressing mode for the data connection is determined as follows:

      • If either of the addresses specified for the control connections is an IPv6 address, the address mode for the data connection is IPv6.
      • If both the addresses specified for the control connections are IPv4 addresses, the ndmpcopy command first attempts an IPv6 address mode for the data connection.

        If that fails, the command uses an IPv4 address mode.

      • When a DNS name is specified for the control connections, the ndmpcopy command attempts an IPv6 DNS lookup followed by an IPv4 DNS lookup.

        The address mode for the data connection is determined by the outcome of the DNS lookup.

    Note: An IPv6 address, if specified, must be enclosed within square brackets.