Veritas NetBackup™ for NDMP Administrator's Guide

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

About existing NetApp cDOT configurations before you upgrade

This topic describes how to upgrade NetBackup with a NetApp cDOT system. If you use a NetApp cDOT system, review the following information before you upgrade to NetBackup 7.7 or later.

If your NetApp cluster is set to node-scope-mode and you have not yet installed NetBackup 7.7 or later, your environment should be set up as follows before the upgrade:

  • The client name that is used in the backup policy is the node-management LIF.

  • Only the volumes that are hosted by the node that hosts the LIF are available for backup or restore. Each node must have a node-management LIF in the client list of the policy.

  • Tape devices that are attached to a node are available for backup or restore.

    • The NDMP host name that is used for the device configuration is the node name (node-management LIF).

    • The tape devices are available only to the nodes to which they are connected.

After you upgrade to NetBackup 7.7 or later, everything works as it did before the upgrade until you enable the NetBackup cDOT capabilities by disabling node-scope mode.

To start using the NetBackup cDOT capabilities, do the following:

  1. Back up the catalog.

  2. (Optional) Create a detailed image catalog report that provides the following:

    • Collects information, such as NDMP host names, policies, and backup selections, that can be used when you create the new cDOT backup policies.

    • Determines the client names to search for when you restore the pre-cDOT backups in the new cDOT environment.

  3. Upgrade all of the NetBackup media servers that are authorized to access the cluster. Upgrades do not have to occur at the same time, but must be done before the following step.

  4. Enable the Vserver aware mode on the cluster by disabling node-scope-mode. Please see your specific cluster documentation.

  5. If there are tape devices attached to the cluster, you must reconfigure your tape devices to use the cluster-management LIF as the NDMP host for the device configuration.

    Caution:

    NetBackup only supports the use of the cluster-management LIF for device configurations.

    Note:

    For each node in the cluster that will have tape devices, be sure to configure all of the tape devices available to the cluster on that node. Any node that has access to a tape device should also have access to all of the tape devices.

  6. Enable the NDMP service on the cluster for each data LIF that will be used for backups. See the NetApp documentation for more information.

  7. Authorize the data LIF as needed for NetBackup access.

  8. Add, delete, or update the old storage units that are using the node names of the cluster.

  9. Add, delete, or update the old policies that back up the cluster.

    • You must use either the data LIF or the cluster-management LIF as the client name. NetBackup does not support use of the node name for the client name.

    • Backup selections may also need to be adjusted.

    Note:

    The use of the data LIF as a client will protect and catalog all volumes associated with the data LIF's Vserver under this client. The use of the cluster-management LIF as a client will protect and catalog all volumes on the entire cluster under this client.

  10. To read the old images, you may have to use alternate client restore. For more information about alternate client restores, see the NetBackup Administrator's Guide for UNIX, Windows, and Linux, Volume I

If your NetApp cluster is set to Vserver aware mode, and you have not yet installed NetBackup 7.7 or later, your environment should be set up as follows before the upgrade:

  • The cluster is in Vserver aware mode. The Cluster Aware Backup (CAB) extension is enabled on the filer. NetBackup does not use the CAB extension.

  • The client name used in the backup policy is the data LIF associated with a Vserver or the cluster-management LIF.

  • Only volumes (that belong to the Vserver) hosted by a node that hosts the data LIF are available for backup or restore.

  • The tape devices that are attached to the cluster are not available for backup or restore.

After you upgrade to NetBackup 7.7 or later, the behavior is different and you need to make some changes. NetBackup now uses the CAB extension and enables it by default. Because of this, the following occurs:

  • NetBackup uses all of the volumes that belong to the Vserver.

  • NetBackup uses the volume affinities.

As a result of this change, the following occurs:

  • When the ALL_FILESYSTEMS directive is in use by multiple policies for the same Vserver, NetBackup may back up the same volume multiple times under different policies. And further incremental backups may not be reliable.

  • Multi-streamed backup jobs will start failing with status code 99. The following message is displayed in the job details for the failed jobs:

    12/10/2014 14:42:11 - Error ndmpagent (pid=29502) NDMP backup failed, 
    path = /vs02/vol1:PARAMETER:AFFINITY=4ac6c4b6-7e99-11e4-b3b6-1779f43af917

    This happens because some components of NetBackup are not told to use the cluster in the Vserver aware mode. It is highly recommended to upgrade and enable the cDOT capabilities as soon as possible.

To start using the cDOT capabilities, you must do the following:

  1. Back up the catalog.

  2. Create a detailed image catalog report (it can be referenced later for read operations).

  3. Upgrade all of the NetBackup media servers that are authorized to access the cluster. All media servers should be upgraded at the same time to avoid inconsistent behavior.

  4. Run the tpautoconf -verify ndmp_host command for each pre-existing LIF that is configured in NetBackup. This command must be run from the media servers that have credentials to the LIF. After the command is successfully run, the nbemmcmd command should display output similar to the following example:

    servername1@/>nbemmcmd -listsettings -machinename machinename123 -machinetype ndmp
    NBEMMCMD, Version: 7.7
    The following configuration settings were found:
    NAS_OS_VERSION="NetApp Release 8.2P3 Cluster-Mode"
    NAS_CDOT_BACKUP="1"
    Command completed successfully.
    
    NAS_OS_VERSION displays the NetApp Version.
    NAS_CDOT_BACKUP tells us if NetBackup uses the new cDOT capabilities.

    Note:

    The tpautoconf -verify ndmp_host command is not required when a new Vserver is added.

  5. You can now add devices to the NDMP cluster and access them using the cluster-management LIF. If you add devices, you must discover the devices.

  6. Add storage units for the newly discovered devices.

  7. Add, delete, or update the policies that reference the cluster as needed. Start using the cluster in Vserver aware mode.

If you do not want to enable the cDOT functionality immediately; for example, you want to upgrade the media servers in phases, you can disable the cDOT capabilities by doing the following:

  1. Create the following touch file on all of the media servers that are authorized to access the NDMP host. This causes NetBackup to disable the CAB extension for all of the NDMP hosts for that media server.

    • On Windows: install_path\NetBackup\db\config\DISABLE_NDMP_CDOT

    • On UNIX: /usr/openv/netbackup/db/config/DISABLE_NDMP_CDOT

  2. You can disable the CAB extensions for specific NDMP hosts by creating the following file on the media servers with one or more NDMP host names (one per line):

    • On Windows: install_path\NetBackup\db\config\DISABLE_NDMP_CDOT_HOST_LIST

    • On UNIX: /usr/openv/netbackup/db/config/DISABLE_NDMP_CDOT_HOST_LIST

      An example of the content of the file is as follows. NetBackup disables the CAB extension only for Filer_1 and Filer_2.

      Filer_1 
      
      Filer_2

      To enable the cDOT functionality, these files must be deleted and you must follow all of the steps explained in the previous upgrade procedure.