Veritas NetBackup™ Vault™ Administrator's Guide

Last Published:
Product(s): NetBackup (8.2, 8.1.2, 8.1.1, 8.1)
  1. About Vault
    1.  
      About Vault
    2.  
      About Vault and NetBackup functions
    3.  
      About accessing NetBackup Vault
    4.  
      About Vaulting original or duplicate images
    5. About the Vault process
      1.  
        About choosing backup images
      2.  
        About duplicating backup images
      3.  
        About backing up the NetBackup catalog
      4.  
        About ejecting media
      5.  
        About generating reports
    6.  
      About how Vault uses volume groups and pools
    7.  
      About NetBackup and Vault configuration
    8.  
      About Vault management procedures
  2. Installing Vault
    1.  
      About supported systems
    2.  
      About supported robots
    3. About installing and configuring Vault on UNIX and Linux systems
      1.  
        Adding a valid license key and configuring Vault for UNIX and Linux systems
      2.  
        About upgrading NetBackup Vault on UNIX and Linux systems
      3.  
        Deleting a Vault license key from UNIX and Linux systems
    4. About installing and configuring Vault on Microsoft Windows systems
      1.  
        Adding a Vault license on a Windows system
      2.  
        About upgrading NetBackup Vault on a Windows system
      3.  
        Deleting the Vault license from a Windows system
  3. Best Practices
    1.  
      About best practices
    2.  
      About vaulting paradigms
    3. About preferred vaulting strategies
      1.  
        About Vault original backups
      2.  
        About disk staging
    4. About how to ensure that data is vaulted
      1. About overlapping the time window in the profile
        1.  
          About the consequences of not overlapping the time window
      2.  
        About resolving multiple names for a single server
      3. About specifying a robotic volume group when configuring a Vault
        1.  
          About multiple volume groups (Multiple robots)
    5. About not Vaulting more than necessary
      1.  
        About sending only the intended backups off-site
      2.  
        About avoiding vaulting partial images
      3.  
        About vaulting original backups in a 24x7 environment
    6. About preparing for efficient recovery
      1.  
        About Vault NetBackup catalog requirements and guidelines
      2.  
        About naming conventions for volume pools and groups
      3.  
        About matching volume pools to data usage
      4.  
        About the primary copy
      5.  
        About suspending vaulted media
      6.  
        About revaulting unexpired media
    7.  
      About media ejection recommendations
    8. About avoiding resource contention during duplication
      1. About two processes trying to use the same drive
        1.  
          Alternative A: dedicated robot for Vault processing
        2.  
          Alternative B: each robot as a Vault robot
        3.  
          Alternative C: one robot as both a backup and Vault robot
      2.  
        About when the read drive is not in the Vault robot
      3.  
        About sharing resources with backup jobs
      4. About load balancing
        1.  
          About profiles for both originals and duplicates
        2.  
          About spreading the workload
      5.  
        About specifying different volume pools for source and destination
      6.  
        About using a separate volume pool for each Vault
    9. About how to avoid sending duplicates over the network
      1.  
        About creating originals concurrently
      2.  
        About using alternate read server
      3.  
        About using advanced duplication configuration
      4.  
        About using storage units that specify a media server
    10. About increasing duplication throughput
      1.  
        About basic multiple-drive configuration
      2.  
        About multiple-drive configuration that does not send data over network
    11.  
      About maximizing drive utilization during duplication
    12.  
      About scratch volume pools
    13. About organizing reports
      1.  
        About organizing reports by robot
      2.  
        About organizing reports by Vault
      3.  
        About organizing reports by profile
      4.  
        About the consequences of sharing an off-site volume group across multiple robots
    14.  
      About generating the lost media report regularly
  4. Configuring NetBackup for Vault
    1.  
      About configuring NetBackup for Vault
    2. About off-site volume pools
      1.  
        Creating a volume pool
    3. About creating catalog backup schedules for Vault
      1. Creating a Vault catalog backup schedule in an existing policy
        1.  
          Vault catalog backup schedule configuration options
    4. About setting master server properties for Vault
      1.  
        Setting the maximum number of Vault jobs
  5. Configuring Vault
    1.  
      About configuring Vault
    2. About Vault configuration
      1.  
        Configuration information about master servers, media servers, and storage units
      2.  
        Robot information
    3.  
      About configuration methods
    4. About configuring Vault Management Properties
      1. General tab (Vault Management Properties)
        1.  
          Configuring Vault Management Properties on the General tab
      2. Alternate Media Server Names tab (Vault Management Properties)
        1.  
          About alternative media server names
        2.  
          About alternate media server names considerations
        3.  
          Adding alternate media server names
      3. Retention Mappings tab (Vault Management Properties)
        1.  
          Configuring global retention mappings
        2.  
          About retention mapping
      4. Reports tab (Vault Management Properties)
        1.  
          Changing report properties
    5.  
      Configuring robots in Vault
    6.  
      Vault Robot dialog box options
    7. About creating a vault
      1.  
        Creating a Vault
      2. About configuring Vault dialog box attributes
        1.  
          Vault Attributes tab options (Vault dialog box)
    8.  
      Media access ports dialog box
    9.  
      Creating retention mappings
    10. About creating profiles
      1.  
        Profile dialog box
      2.  
        About the number of profiles required
    11.  
      Creating a profile
    12. Configuring a profile
      1.  
        About configuring a profile using the Choose Backups tab
      2.  
        Choose Backups tab configuration options
      3. Duplication tab
        1.  
          About the primary backup copy
        2.  
          About basic duplication
        3.  
          About advanced duplication
        4.  
          Duplication tab configuration options
        5.  
          Multiple Copies options
        6.  
          Duplication Rule configurations
        7.  
          About the treatment of images without a corresponding duplication rule
      4. Catalog backup tab (Profile dialog box)
        1.  
          About Vault catalog backups
        2.  
          Catalog backup policy settings
        3.  
          About critical policies
        4.  
          Catalog backup tab configuration options
      5. Eject tab (Profile dialog box)
        1.  
          About media ejection
        2.  
          About ACS MAP
        3.  
          About eject mode (immediate or deferred)
        4.  
          About media ejection timeout impact
        5.  
          Eject tab configuration options
      6. Reports tab (Profile dialog box)
        1.  
          About report mode (immediate or deferred)
        2.  
          Reports that depend on eject
        3.  
          Reports tab configuration options
        4.  
          Changing report properties
  6. Vaulting and managing media
    1. About Vault sessions
      1. About scheduling a Vault session
        1.  
          Creating a Vault policy
        2.  
          Vault policy configuration information
      2. About running a session manually
        1.  
          Running a Vault session from the NetBackup Administration Console
        2.  
          Running a session from a command line
      3.  
        About running multiple sessions simultaneously
    2.  
      About previewing a Vault session
    3.  
      Stopping a Vault session
    4.  
      About resuming a Vault session
    5. About monitoring a Vault session
      1.  
        About detailed Vault job status
      2.  
        About extended error codes
    6. About the list of images to be vaulted
      1.  
        About duplication exclusions
      2.  
        About ejection exclusions
      3.  
        About Vault resiliency
    7. About ejecting media
      1.  
        Previewing media to be ejected
      2.  
        Ejecting media by using the NetBackup Administration Console
      3.  
        Ejecting media by using the Vault operator menu
      4.  
        Ejecting media by using the vlteject command
      5.  
        Ejecting media by using a Vault policy
      6.  
        Consolidating ejects and reports
    8. About injecting media
      1.  
        Injecting media for libraries with and without barcode readers
      2.  
        Injecting media by using the Vault Operator Menu
      3.  
        Injecting media by using the vltinject command
    9. About using containers
      1. About vaulting media in containers
        1.  
          Vaulting container media by using the Vault operator menu
        2.  
          Vaulting container media by using the vltcontainers command
      2. About managing containers and media
        1.  
          Managing container media by using the Vault operator menu
        2.  
          Managing container media by using the vltcontainers command
      3.  
        Generating a Container Inventory Report
    10.  
      Assigning multiple retentions with one profile
    11. About vaulting additional volumes
      1.  
        Duplicating a volume manually
      2.  
        Duplicating a volume by using Vault
    12.  
      Revaulting unexpired media
    13.  
      About tracking volumes not ejected by Vault
    14.  
      Vaulting non-NetBackup media managed by Media Manager
    15.  
      About notifying a tape operator when an eject begins
    16. About using notify scripts
      1.  
        About notify script for a specific robot
      2.  
        About notify script for a specific Vault
      3.  
        About notify script for a specific profile
      4.  
        Notify script order of execution
    17.  
      About clearing the media description field
    18.  
      Restoring data from vaulted media
    19.  
      Replacing damaged media
  7. Creating originals or copies concurrently
    1.  
      About concurrent copies
    2. About the continue or fail for concurrent copies
      1.  
        About continue copies
      2.  
        About fail all copies
    3.  
      Creating multiple original images concurrently
    4. About creating duplicate images concurrently
      1.  
        Creating concurrent copies through the catalog node
      2.  
        Creating concurrent copies using the basic duplication tab
      3.  
        Creating concurrent multiple copies using the advanced duplication options
  8. Reporting
    1.  
      About reports
    2. About generating reports
      1.  
        Generating reports by using the Vault operator menu
      2.  
        Generating reports by using the vlteject command
      3.  
        Creating a Vault policy to generate reports
    3. About consolidating reports
      1.  
        About consolidated reports in previous Vault releases
    4.  
      Viewing Vault reports
    5. Vault report types
      1. Reports for media going off site
        1.  
          Picking List for Robot report
        2.  
          Distribution List for Vault report
        3.  
          Detailed Distribution List for Vault report
        4.  
          Summary Distribution List for Vault report
      2. Reports for media coming on-site
        1.  
          Picking List for Vault report
        2.  
          Distribution List for Robot report
      3. Inventory reports
        1.  
          Vault Inventory report
        2.  
          Off-site Inventory report
        3.  
          All Media Inventory report
        4.  
          Container Inventory report
        5.  
          Recovery Report for Vault report
      4.  
        Lost Media report
      5.  
        Non-vaulted Images Exception report
      6.  
        About the Iron Mountain FTP file
  9. Administering Vault
    1.  
      About setting up email
    2. About administering access to Vault
      1.  
        About the Vault Operator user group permissions
    3.  
      About printing Vault and profile information
    4.  
      Copying a profile
    5.  
      About moving a vault to a different robot
    6.  
      About changing volume pools and groups
    7. About NetBackup Vault session files
      1.  
        About setting up Vault session log files
      2.  
        Setting the duration of Vault session files
    8.  
      Operational issue with disk-only option on Duplication tab
    9.  
      Operational issues with the scope of the source volume group
  10. Using the menu user interface
    1.  
      About using the menu interfaces
    2.  
      About the Vault administration interface
    3.  
      Vault operator menu interface
    4.  
      Vault fields in bpdbjobs output
  11. Troubleshooting
    1.  
      About troubleshooting Vault
    2.  
      About printing problems
    3.  
      About errors returned by the Vault session
    4.  
      About media that are not ejected
    5.  
      About media that is missing in robot
    6.  
      Reduplicating a bad or missing duplicate tape
    7.  
      About the tape drive or robot offline
    8.  
      No duplicate progress message
    9.  
      About stopping bpvault
    10.  
      About ejecting tapes that are in use
    11.  
      About tapes not removed from the MAP
    12.  
      Revaulting unexpired tapes
    13. Debug logs
      1.  
        Setting the duration and level for log files
      2.  
        Logs to accompany problem reports
  12. Appendix A. Recovering from disasters
    1. About disaster recovery
      1.  
        About what defines a disaster
      2.  
        About the disaster recovery process
      3.  
        About disaster recovery plans
      4.  
        About recovery priorities
      5.  
        About developing disaster recovery plans
      6.  
        About testing disaster recovery plans
    2.  
      About disaster recovery in the NetBackup Vault context
    3.  
      About preparing for recovery
    4.  
      About recovering NetBackup
    5.  
      Recovering data and restoring backup images
    6.  
      Archiving and recovering from a specific point in time
  13. Appendix B. Vault file and directory structure
    1.  
      UNIX files and directories
    2.  
      Windows files and directories

Replacing damaged media

If media in your robot is damaged, you can use copies of the media (if available) from your off-site storage location to replace the damaged media. You also can use this process to recover images if the primary backup expired, the volume was overwritten, and a copy in off-site storage is still available.

Note:

This image recovery process assumes that the NetBackup system and image catalog are current and up to date.

The instructions use an example to illustrate how to run the various commands that are used in the recovery process. Modify the command examples as appropriate for your purposes.

Most of the commands used to recover from damaged media are in the following directory:

  • UNIX

    /usr/openv/netbackup/bin/admincmd
  • Windows

    install_path\netbackup\bin\admincmd

After you recover and restore the damaged media, you should revault the media so that it again is available for recovery.

See Revaulting unexpired media.

To replace damaged media

  1. Identify the damaged media.

    When you receive an error message during a restore, the errors are logged to the restore log and also show up on the Activity Monitor as the restore fails. You can set up a procedure using NetBackup scripts to send errors to an event management console to notify the storage administrator immediately of this type of media error.

  2. Determine which backup images are on the damaged tape.

    To identify all images on a specific tape, run the bpimmedia command. It scans the entire NetBackup image catalog, so it may take a few minutes depending on the size of that catalog. For example, the following shows that volume S05423 contains one image from client fgolddust. It also shows that this image was duplicated because it has (FRAG 2) entries. The full image name is "fgolddust_0862806643":

    # bpimmedia -mediaid S05423
    IMAGE fgolddust 2 fgolddust_0862806643 golddust_BR1 0 
    Full_Weekly 0 3 19360 8654 85043 0 0
    FRAG 1 -1 2293 0 2 6 2 S05423 nirvana 64512 0 862804830 3 0 
    *NULL*
    FRAG 1 1 232848 0 2 6 1 S02643 nirvana 64512 2 862804830 3 0 
    *NULL*
    FRAG 1 2 1225539 0 2 6 2 S02643 nirvana 64512 0 862804830 3 0 
    *NULL*
    FRAG 1 3 70182 0 2 6 3 S02643 nirvana 64512 0 862804830 3 0 
    *NULL*
    FRAG 1 4 825700 0 2 6 1 S05423 nirvana 64512 2 862808446 3 0 
    *NULL*
    FRAG 2 -1 2293 0 2 6 2 S04440 nirvana 32768 0 862927577 2 0 
    *NULL*
    FRAG 2 1 2335584 0 2 6 1 S04440 nirvana 32768 2 862927577 2 0 
    *NULL*
  3. Determine which duplicate tapes were used and their host.

    In step 2, the (FRAG 2) entries show that an image was duplicated: the (FRAG 2 1) entry is the duplicate copy. On copy 1 there were four fragments (usually due to multiplexing). The (FRAG 2 -1) entry is the true image restore duplicate. In this case, the image fgolddust_0862806643 uses media S04440 for duplicating all of the original fragments. This is normal because the original image was multiplexed onto four tapes, while the duplicate was de-multiplexed during image duplication, and could fit on one tape.

    Also note that the host for the media is printed for each fragment, in this case nirvana. With media servers, the host could be different than the master server. Under Vault, the duplication should normally occur on the same server that made the original backup, so the host server names are the same for both copies of the image.

    To confirm this information, use the bpimagelist command, as follows:

    # bpimagelist -backupid fgolddust_0862806643
    IMAGE fgolddust 0 0 2 fgolddust_0862806643 golddust_BR1 0 *NULL* 
    root Full_Weekly 0 3 862806643 4591 865485043 0 0 2356562 19360 
    2 7 1 golddust_BR1_0862806643_FULL.f *NULL* *NULL* 0 1 0 2 
    865830643 *NULL* 1 0 0 0 0 *NULL*
    HISTO -1 -1 -1 -1 -1 -1 -1 -1 -1 -1
    FRAG 1 -1 2293 0 2 6 2 S05423 nirvana 64512 0 862804830 3 0 
    *NULL*
    FRAG 1 1 232848 0 2 6 1 S02643 nirvana 64512 2 862804830 3 0 
    *NULL*
    FRAG 1 2 1225539 0 2 6 2 S02643 nirvana 64512 0 862804830 3 0 
    *NULL*
    FRAG 1 3 70182 0 2 6 3 S02643 nirvana 64512 0 862804830 3 0 
    *NULL*
    FRAG 1 4 825700 0 2 6 1 S05423 nirvana 64512 2 862808446 3 0 
    *NULL*
    FRAG 2 -1 2293 0 2 6 2 S04440 nirvana 32768 0 862927577 2 0 
    *NULL*
    FRAG 2 1 2335584 0 2 6 1 S04440 nirvana 32768 2 862927577 2 0 
    *NULL*

    To confirm which is the primary copy (the copy to use for restores), use the -L option with bpimagelist, as follows:

    UNIX: # bpimagelist -L -backupid fgolddust_0862806643 | grep 
    Primary
    Primary Copy: 1
    Windows: bpimagelist -L -backupid fgolddust_0862806643 | find 
    Primary
    Primary Copy: 1
  4. Tell NetBackup to use the duplicated copy rather than the original.

    Run the bpimage -npc command and option to change the primary copy. The new primary copy is used for restoring an image:

    # bpchangeprimary -copy 2 -id fgolddust_0862806643 -cl fgolddust

    To confirm the new primary copy, use the following command:

    UNIX: # bpimagelist -L -backupid fgolddust_0862806643 | grep 
    Primary
    Primary Copy: 2
    Windows: bpimagelist -L -backupid fgolddust_0862806643 | find 
    "Primary"
    Primary Copy: 2
  5. Freeze the duplicated copy to ensure restore.

    Use the command bpmedia -freeze to prevent NetBackup from expiring the images on the media and to ensure that the media is assigned in Media Manager. You should also use the media host for this image that was printed by bpimmedia in step 2. This is required when the host is different than the computer on which you are running this command.

    bpmedia -freeze -m S04440 -host nirvana
  6. Recall media from the vault.

    Recall the appropriate volume from off-site storage.

    To determine the media ID, slot number, or container ID of the tape to recall, use the vmquery command, located in the following directory:

    • UNIX

      /usr/openv/volmgr/bin
    • Windows

      install_path\volmgr\bin.

    In the following example, the slot number (S278) is listed in the vault slot field:

    vmquery -m S04440
    ===============================================================
    media ID:                 S04440     
    media type:               8MM cartridge tape (4)     
    barcode:                  S04440     
    media description:        Added by Media Manager     
    volume pool:              Vaulted_CustomerDB (2)     
    robot type:               NONE - Not Robotic (0)     
    volume group:             DB_offsite_volumes     
    vault name:               Customer_DB_Vault     
    vault sent date:          ---     
    vault return date:        ---     
    vault slot:               S278     
    vault session id:         1     
    created:                  Tue Sep 3 10:08:32 2000     
    assigned:                 Tue May 6 00:11:45 2001     
    last mounted:             Tue May 6 11:34:25 2001     
    first mount:              Tue Sep 3 18:20:48 2000     
    expiration date:          ---     
    number of mounts:         21     
    max mounts allowed:       ---     
    ===============================================================
  7. Inject recalled media back into the robot.

    When the tape is returned from the off-site vendor, inject it into the appropriate robotic library. First, insert the tape into the robot media access port. Then, from the NetBackup Administration Console, choose Media and Devices Management. Choose the Inventory Robot... option. Select the Empty Media Access Port Prior to Update checkbox.

    You can also perform this function using the vltinject command.

  8. Perform a normal restore operation.

    The restore should read from the new primary copy. The restore log should show a mount request for the duplicate media.

  9. Unfreeze media that is used for duplicates.

    After the restore is successful, unfreeze the duplicate media to allow the normal expiration process. If you want to send the tape off-site again, either remove it from the robot or leave it in the robot as the primary copy. Veritas recommends that you suspend the media so that no images are written to it.

    bpmedia -unfreeze -m S04440 -host nirvana
  10. Create new duplicate images.

    Optionally, you can create new duplicate images for transfer to your off-site vault vendor.

    See Reduplicating a bad or missing duplicate tape.

  11. Modify the NetBackup catalog for a large number of images.

    In a disaster recovery situation in which a large number of images need their primary copy modified, run the bpchangeprimary command. This command changes the primary copy of all the backup images in the off-site volume pool for which the media was returned from the off-site vault.