Setting NDMP Backup Source Options

The Set Job Source Options dialog controls behavior during a backup operation when it encounters specific source nodes and file types. The Set Job Source Options dialog also allows you to run scripts automatically on UNIX and Windows nodes before or after a backup job. See Chapter 29: Pre-Scripts and Post-Scripts.

To set backup source options:

  1. Open the Set Job Source Options dialog box by doing one of the following:

    • Right-click the enterprise name or icon to display a context menu. Then click Set Source Options.

    • From the menu bar, select Backup > Set Source Options.

    • From the task panel, click Set Source Options.

    The Set Job Source Options dialog box appears.

  2. Complete the Set Job Source Options dialog box as needed.

Job Source Options for NDMP Backup

The Set Job Source Options dialog allows you to set options related to backup sources. The options displayed depend on the backup mode. An explanation of each field in the dialog and the available choices is provided in this section.

The following fields display on the Source tab:

  • 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 Intervals (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.

  • NDMP File History Handling

Controls file history generation for NDMP and Block backup tasks.

For Block backups, recovery through the use of Instant Access provides for granular file-level restore regardless of whether file history was generated or not. Instant Access allows Block backups to be run very frequently by eliminating the need to include file histories during backup. For information on using Instant Access for file-level restore, see Instant Access as a File History Alternative in the User’s Guide.

Disable File History

Disables NDMP server file history generation.

Process File History on Local Client

Enables 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

Appliance Enables NDMP server file history generation but transmits the file history data to the master server node for processing.

Related Topics:

  • 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

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

The following fields display on the Script tab:

Pre-Job Script

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

If Pre-Script fails

The action to take if the Pre-Job Script fails to successfully complete.

If Job fails

The action to take if the Job fails to successfully complete.

Post-Job Script

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

See also. For more information about the Pre-Job Scripts and Post-Job Scripts, see Chapter 29: Pre-Scripts and Post-Scripts.

Last updated