Veritas NetBackup™ for NDMP Administrator's Guide

Last Published:
Product(s): NetBackup (8.1.2)
  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)

Wildcard characters in backup selections for an NDMP policy

You can use wildcard characters in regular expressions or the directive ALL_FILESYSTEMS to specify path names in NDMP policy backup selections.

Wildcard characters in regular expressions or directives are valid for streaming and non-streaming NDMP backups.

Note:

Directory-level expansion is not supported for some NDMP servers. Some NDMP filer vendors do not have the APIs that NetBackup uses to support wildcard characters lower than the volume level.

If you specify a backup selection using wildcard characters lower than the volume level for these filers, status code 106 is generated. The following message is displayed: Invalid file pathname found, cannot process request.

Currently, only NetApp filers support wildcard characters for backup selections lower than the volume level. This support is not available in NetApp clustered Data ONTAP version 8.2. To see the versions of NetApp Data ONTAP that support wildcard characters for backup selections lower than the volume level, refer to the NetBackup Master Compatibility List.

You cannot use any wildcard characters that also match file names. For example, a backup selection might include /vol/vol_archive_01/autoit*. This specification might match a path name such as /vol/vol_archive_01/autoit_01/. However, if this specification also matches a file name like /vol/vol_archive_01/autoit-v1-setup.exe, the backup job fails with status code 99 because wildcards can specify only path names. The following message is displayed: NDMP backup failure (99).

Table: Valid wildcard characters for NDMP policy backup selections

Wildcard character

Description

*

Specifies a string match. For example:

/vol/vol_archive_*

This form of the path specification matches all paths that begin with the literal characters /vol/vol_archive_ and end with any characters.

The string match wildcard can also specify multiple variable characters between literal characters as in the following examples:

/vol/ora_*archive or /vol/ora_*archive*

/vol/ora_vol/qtree_*archive or /vol/ora_vol/qtree_*archive*

?

Specifies a single-character match.

/fs?

This path specification matches all paths that begin with the literal characters /fs and end with any single character. For example, /fs1,/fs3, /fsa, /fsd and so on match the specified pattern /fs?.

[...]

Specifies an alphanumeric pattern match. For example:

/fs[1-9]

This path specification matches all paths that begin with the literal characters /fs and end with any single numeric character from 1 through 9. For example, /fs1,/fs2, and so on up to /fs9 match the specified pattern /fs[1-9]. However, /fs0 and /fsa do not match the specified pattern; 0 is out of the specified numeric range, and a is a non-numeric character.

The pattern match wildcard can also specify alphanumeric patterns such as /fs[1-5a]. This specification matches /fs1, /fs2, and so on up to /fs5 as well as /fsa.

Similarly, the pattern match wildcard can also specify patterns like /fs[a-p4]. This specification matches /fsa, /fsb, and so on up to /fsp as well as /fs4.

You must use multiple backup selection specifications if the pattern can match more than 10 volume names in a numeric series. For example, you may want to back up 110 volumes that begin with the literal characters /vol/ndmp and are numbered 1 through 110. To include these volumes in a backup selection with wildcards, specify three backup selections with the following wildcard patterns:

  • /vol/ndmp[0-9]

    This pattern matches any volume name that begins with /vol/ndmp and ends with a single numeric character 0 through 9.

  • /vol/ndmp[0-9][0-9]

    This pattern matches any volume name that begins with /vol/ndmp and ends with the two-digit numeric characters 00 through 99.

  • /vol/ndmp[0-9][0-9][0-9]

    This pattern matches any volume name that begins with /vol/ndmp and ends with the three-digit numeric characters 000 through 999.

Do not specify /vol/ndmp[1-110] in this example. This pattern produces inconsistent results.

{...}

Curly brackets can be used in the backup selection list and the VOLUME_EXCLUDE_LIST directive for NDMP policies.

A pair of curly brackets (or braces) indicates multiple volume or directory name patterns. Separate the patterns by commas only; no spaces are permitted. A match is made for any or all entries.

For example:

{*volA,*volB} or {volA*,volB*}

Note the following restrictions and behaviors regarding wildcard expressions:

  • Veritas recommends that you do not use a single forward-slash character (/) in an NDMP policy backup selection. This method of including all the volumes on an NDMP filer in the selection is not supported. Instead, use the ALL_FILESYSTEMS directive:

    See ALL_FILESYSTEMS and VOLUME_EXCLUDE_LIST directives.

  • Nested wildcard expressions can result in recursive path name expansion operations that can impact performance, especially for directories that have a very large number of files or directories. An example of nested wildcard expansion is as follows:

    /vol/fome06/*/*private

  • Wildcard expressions do not span or include a path separator (/).

  • All backup selections that contain a wildcard expression must start with a path separator (/). An example of a correct wildcard expression is as follows:

    /vol/archive_*

    An example of an incorrect wildcard expression is as follows:

    vol/archive_*