Skip to main content
Version: DPX 4.15

Job Source Options for NDMP Backup

To access the job source options, do the following:

  1. Go to Job Manager in the sidebar.
  2. Open an already existing backup job.
    Or create a new NDMP backup job, by clicking the New Backup Job button in the upper right corner and then selecting Backup Type NDMP.
  3. Go to the Advanced Options section at the bottom (scroll down if necessary) and expand it.
    Click any of the following section headers to expand. Each field and the available choices are explained below.

[image expected here]

Note.

The Advanced Options section in the web interface also includes job destination options which are discussed in a separate section for the sake of clarity. See Job Destination Options for NDMP Backup.

The Source Options section​

[image expected here]

Down node retries

Controls how DPX behaves when it cannot establish contact with a node during a backup operation. If you enter zero, DPX skips unreachable nodes. If you enter a number, DPX waits until all the reachable nodes have been backed up and then retries the nodes that it could not back up on its first attempt. The number you enter determines how many times DPX tries to reach unreachable nodes.

Task retry interval (minutes)

Determines how long to wait before retrying failed tasks.

When a task fails (due to permission problems, open files, interim job changes, etc.), it waits the number of minutes specified in this field before attempting that task again. Because the same failure might occur if the task is retried too soon, it is better to allow some time for an error to be corrected before retrying the task. A task is only retried once. Failing tasks appear in error message lists in the Job Log. All tasks are subject to retry.

The File Index/History Options section​

[image expected here]

This section controls file history generation for NDMP backup tasks.

Disable File HistoryDisables NDMP server file history generation.
Process File History on Local ClientEnables NDMP server file history generation and processes the file history data on the NDMP client node. This is the default.
Process File History on Master Server ApplianceEnables NDMP server file history generation but transmits the file history data to the master server node for processing.
See also.

Generic NDMP Restore with File History Processing in the DPX 4.9 Reference Guide

The NDMP Options section​

[image expected here]

Enable NDMP Server Logging

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

YesAll NDMP server log messages will be routed to the master server’s job log file. Yes is the default.
NoThe NDMP server log messages will be logged locally in the NDMP client node log file instead of in the master server’s job log file.

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.

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.

Note.

Alternative syntax, e.g. env1name value;env2name value;... (semicolon-delimited, no equal sign) or env1name valueenv2name value... (no delimiter, no equal sign) may be displayed in the interface. However, for the sake of clarity, the env1name=value,env2name=value,... version is strongly recommended.

Attention!

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 the 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.

The Script Options section​

[image expected here]

Pre-job script

Enter the name of a script to execute prior to the actual job.

Basic usage: <script>@<node_name> <argument_list>

If pre-script fails

The action be taken if the Pre-Job Script fails to successfully complete:

  • Run job / run post-job script
  • Skip job / run post-job script
  • Skip job / skip post-job script

If job fails

The action to be taken if the Job fails to successfully complete:

  • Run post-job script
  • Skip post-job script

Post-job script

Enter the name of a script to execute after the actual job.

Basic usage: <script>@<node_name> <argument_list>

See also.

For detailed information about pre- and post-job scripts, including all valid definitions, see Pre-Scripts and Post-Scripts.