Veritas NetBackup™ for NDMP Administrator's Guide

Last Published:
Product(s): NetBackup (8.1)
  1. Introduction to NetBackup for NDMP
    1. About NetBackup for NDMP
      1.  
        NetBackup for NDMP features
      2.  
        NetBackup for NDMP terminology
    2.  
      About Network Data Management Protocol (NDMP)
    3. Types of NDMP backup
      1.  
        NDMP local backup
      2.  
        NDMP three-way backup
      3.  
        Backup to Media Manager storage units (remote NDMP)
    4.  
      About NDMP policies in NetBackup
    5.  
      About NetBackup storage units
    6. About assigning tape drives to different hosts
      1.  
        About robotics control
    7.  
      About the NDMP backup process
    8.  
      About the NDMP restore process
    9.  
      About Direct Access Recovery (DAR)
    10.  
      Snapshot Client assistance
    11.  
      About NDMP multiplexing
    12.  
      About NDMP support for Replication Director
    13.  
      Limitations of Replication Director with NDMP
    14.  
      About NDMP support for NetApp clustered Data ONTAP (cDOT)
  2. Installation Notes for NetBackup for NDMP
    1.  
      NetBackup for NDMP installation prerequisites
    2.  
      About existing NetApp cDOT configurations before you upgrade
  3. Configuring NDMP backup to NDMP-attached devices
    1.  
      About configuring NDMP-attached devices
    2.  
      Authorizing NetBackup access to a NAS (NDMP) host
    3.  
      About access for three-way backups and remote NDMP
    4. About Media and Device Management configuration
      1.  
        Adding a robot directly attached to an NDMP host
      2.  
        Adding a tape drive
      3.  
        Checking the device configuration
    5.  
      Using the Device Configuration Wizard to configure an NDMP filer
    6.  
      About adding volumes
    7.  
      About verifying NDMP password and robot connection
    8.  
      Adding NDMP storage units
    9. About creating an NDMP policy
      1.  
        Attributes tab options for an NDMP policy
      2.  
        Schedules tab options for an NDMP policy with Accelerator for NDMP enabled
      3.  
        Clients tab options for an NDMP policy
      4. Backup selection options for an NDMP policy
        1.  
          Wildcard characters in backup selections for an NDMP policy
        2.  
          ALL_FILESYSTEMS and VOLUME_EXCLUDE_LIST directives
      5.  
        About environment variables in the backup selections list
      6.  
        About appropriate host selection for NetApp cDOT backup policies
      7.  
        About backup types in a schedule for an NDMP policy
    10. About enabling or disabling DAR
      1.  
        Disabling DAR for file and directory restores
      2.  
        Disabling DAR for directory restores only
    11.  
      Configuring NetBackup for NDMP in a clustered environment
  4. Configuring NDMP backup to NetBackup media servers (remote NDMP)
    1.  
      About remote NDMP
    2.  
      Configuring NDMP backup to Media Manager storage units
  5. Configuring NDMP DirectCopy
    1. About NDMP DirectCopy
      1.  
        Prerequisites for using NDMP DirectCopy
      2.  
        NDMP DirectCopy with VTL
      3.  
        NDMP DirectCopy without VTL
    2.  
      Configuring NDMP DirectCopy
    3. Using NDMP DirectCopy to duplicate a backup image
      1. Requirements to use NDMP DirectCopy for image duplication
        1.  
          NetBackup policy type for image duplication
      2.  
        Initiating NDMP DirectCopy with the NetBackup Administration Console
  6. Accelerator for NDMP
    1.  
      About NetBackup Accelerator for NDMP
    2. About the track log for Accelerator for NDMP
      1.  
        How to redirect track logs for Accelerator for NDMP
    3.  
      Accelerator messages in the NDMP backup job details log
    4.  
      NetBackup logs for Accelerator for NDMP
  7. Remote NDMP and disk devices
    1.  
      About remote NDMP and disk devices
    2.  
      Configuring remote NDMP
  8. Using the Shared Storage Option (SSO)
    1.  
      About the Shared Storage Option (SSO) with NetBackup for NDMP
    2.  
      Setting up SSO with NetBackup for NDMP
    3.  
      Using the NetBackup Device Configuration Wizard for NDMP hosts
  9. Backup and restore procedures
    1.  
      About NDMP backups and restores
    2.  
      Performing a manual backup with an NDMP policy
    3.  
      Performing an NDMP restore from the server
  10. Troubleshooting
    1. About NetBackup for NDMP logs
      1.  
        Viewing NetBackup for NDMP logs
      2.  
        NDMP backup levels
    2.  
      General NetBackup for NDMP operating notes and restrictions
    3. NetBackup for NDMP troubleshooting suggestions
      1.  
        Troubleshooting NDMP media and devices on Windows
      2.  
        Troubleshooting NDMP media and devices on UNIX
      3.  
        Troubleshooting NDMP DirectCopy
      4.  
        Troubleshooting Direct Access Recovery (DAR) with NetBackup for NDMP
    4. About robot tests
      1.  
        TL8 robot test example for Windows
      2.  
        TLD robot test example for UNIX
      3.  
        TLH robot test example for UNIX
  11. Using NetBackup for NDMP scripts
    1.  
      About the NetBackup for NDMP scripts
    2.  
      ndmp_start_notify script (UNIX)
    3.  
      ndmp_start_notify.cmd script (Microsoft Windows)
    4.  
      ndmp_end_notify script (UNIX)
    5.  
      ndmp_end_notify.cmd script (Microsoft Windows)
    6.  
      ndmp_start_path_notify script (UNIX)
    7.  
      ndmp_start_path_notify.cmd script (Microsoft Windows)
    8.  
      ndmp_end_path_notify script (UNIX)
    9.  
      ndmp_end_path_notify.cmd script (Microsoft Windows)
    10.  
      ndmp_moving_path_notify script (UNIX)
    11.  
      ndmp_moving_path_notify.cmd script (Microsoft Windows)

ndmp_start_notify script (UNIX)

The UNIX scripts are provided as examples only. You must customize the scripts before using them. For example, the -ne value in the first if statement must be modified to reflect the number of passed parameters. For the ndmp_start_notify script, the -ne value must be set to 7.

On the UNIX media server, NetBackup calls the ndmp_start_notify script each time the client starts a backup operation. To use this script, create a script similar to

  /usr/openv/netbackup/bin/goodies/bpstart_notify

on the server, and copy it to

  /usr/openv/netbackup/bin/ndmp_start_notify

on the UNIX NetBackup for NDMP server. Then, modify the script and ensure that you have permission to run it.

Note:

Before you use this script, make sure that you can run it by using other on the media server. Run chmod 755 script_name, where script_name is the name of the script.

The ndmp_start_notify script runs each time a backup starts and after the tape has been positioned. This script must exit with a status of 0 for the calling program to continue and for the backup to proceed. A nonzero status causes the client backup to exit with a status of ndmp_start_notify failed.

If the /usr/openv/netbackup/bin/ndmp_start_notify script exists, it runs in the foreground. The bptm process that is on the NetBackup for NDMP server waits for it to complete before continuing. Any commands in the script that do not end with an & character run serially.

The server expects the client to respond with a continue message within the period of time that the NetBackup CLIENT_READ_TIMEOUT option on the server specifies.

The default for CLIENT_READ_TIMEOUT is 300. If the script needs more time than 300 seconds, increase the value to allow more time.

NetBackup passes the following parameters to the script:

Table: Script parameters for ndmp_start_notify (UNIX)

Parameter

Description

$1

Specifies the name of the NDMP host.

$2

Specifies the policy name from the NetBackup catalog.

$3

Specifies the schedule name from the NetBackup catalog.

$4

Specifies one of the following:

FULL

INCR (differential incremental)

CINC (cumulative incremental)

$5

Specifies the NetBackup status code for the operation.

For example:

ndmp_start_notify freddie cd4000s fulls FULL 0
ndmp_start_notify danr cd4000s incrementals INCR 0
ndmp_start_notify hare cd4000s fulls FULL 0

To create an ndmp_start_notify script for a specific policy or policy and schedule combination, create script files with a .policyname or .policyname.schedulename suffix. In the following two examples of script names, the policy is named production and the schedule is named fulls:

/usr/openv/netbackup/bin/ndmp_start_notify.production
/usr/openv/netbackup/bin/ndmp_start_notify.production.fulls

The first script affects all scheduled backups in the policy that is named production. The second script affects scheduled backups in the policy that is named production only when the schedule is named fulls.

Note:

For a given backup, NetBackup uses only one ndmp_start_notify script and that is the one with the most specific name. For example, if there are both ndmp_start_notify.production and ndmp_start_notify.production.fulls scripts, NetBackup uses only ndmp_start_notify.production.fulls.

The ndmp_start_notify script can use the following environment variables:

BACKUPID
UNIXBACKUPTIME
BACKUPTIME

The NetBackup bptm process creates these variables. The following are examples of the strings that are available to the script for use in recording information about a backup:

BACKUPID=freddie_0857340526
UNIXBACKUPTIME=0857340526
BACKUPTIME=Sun Mar 2 16:08:46 1997