Job Destination Options for NDMP Restore

The Set Job Destination Options dialog allows you to set options related to restore destinations. The options displayed depend on the restore mode.

An explanation of each field in the dialog and the available choices follows:

• Existing File Handling

  Tells DPX how to behave if it finds a file at the destination with the same name as the file that it is restoring.

  Replace Existing Files	Restores the file to a temporary file, ensures that the restore is successful, and then writes over the existing file with the like-named file being restored.
  Delete Existing Files Before Restore	Restores the file to a temporary file, ensures that the restore is successful, and then writes over the existing file with the like-named file being restored.

• Missing Directories

  Controls how DPX behaves if it tries to restore a file to a directory and discovers that the directory does not exist.

  Use Full Privileges	Uses the file privileges the file possessed when it was originally backed up.
  Use Parent Privileges	Applies the file privileges of the parent directory into which the files are being restored.
  Use Root Privileges	Applies the file privileges of the root directory into which the files are being restored.

The next field only applies when you are restoring data to a new location.

• Destination Path

  Destination Path determines whether DPX retains the original tree structure when you restore to a new location.

  Absolute Path	Retains the original tree structure. For example, if on a Windows machine you backed up C:\NewPrjs\Dev\Bin, and restore to C:\NewPrjs\Test, the absolute destination path is C:\NewPrjs\Test\NewPrjs\Dev\Bin.
  Relative Path	Removes the parent directories and puts the file in the new restore directory. For example, if on a Windows machine you backed up C:\NewPrjs\Dev\Bin, and restore to C:\NewPrjs\Test, the relative destination path is C:\NewPrjs\Test\Bin.

• Additional NDMP Environment

  This option allows you to introduce any additional NDMP environment variables that are necessary for the backup task. Specify your environment variables as an ASCII string with an environment variable name and value pairs using the following syntax:

  env1name=value,env2name=value,...

  Note that syntax validation is not performed on the specified value at job definition time, but rather at run time. Only valid entries are added to the NDMP operation environment.

  Do not specify any of the following NDMP environment variables in your variable string because DPX controls these specifically:

  • BASE_DATE

  • DEBUG

  • DIRECT

  • DUMP_DATE

  • EXTRACT

  • FILES

  • FILESYSTEM

  • HIST

  • LEVEL

  • PREFIX

  • RECOVER_FILEHIST

  • SINCE_TIME

  • TYPE

  • UPDATE

  • VERBOSE

  Specifying the variables above may cause unexpected results due to unpredictability of the order in which they are evaluated. NDMP servers from different vendors may support different NDMP environment variables. Except for a few well-known environment variable names, there is currently no standardized set of such variables. This option allows you to add environmental variables specific to your NDMP server.

• NDMP Recover Mode

  Determines the type of recover operation to perform in NDMP restore tasks.

  Extract	Only the selected files and/or directories are restored.
  Direct	Direct Access Recovery (DAR) is performed. Select this option only if the NDMP server supports DAR.
  True Image	Rebuilds an entire file system or subtree if base and incremental backups are restored in order.

• Enable NDMP Server Logging

  Controls the routing of NDMP server generated log messages to the job log file.

  Yes	All NDMP server log messages will be routed to the master server’s job log file. Yes is the default.
  No	Direct Access Recovery (DAR) is performed. Select this option only if the NDMP server supports DAR.

Related Topics:

• Point-in-Time Recovery