Veritas NetBackup™ Vault Administrator's Guide

Last Published:
Product(s): NetBackup (9.0.0.1, 9.0)
  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 Vault
    1.  
      About configuring NetBackup 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
  14.  
    Index

About NetBackup Vault session files

The directory that is generated for each vault session collects information for the session in 2 log files. The detail.log file contains a record of each action that is performed for the session. Some of the information in detail.log is also recorded in the NetBackup log files. The summary.log file contains a brief description of the vault session, and the results of the session. If email notification is enabled, the information in this file is appended to the email.

The detail.log has information about the number of images that are selected by a particular session. In addition, it should record information (during the duplication step) about the total number of images and the number of images duplicated. If these numbers do not match, it means that some images were not duplicated. The log should contain information about which images were not duplicated, either because they were duplicated in a previous session or because the duplication failed for some reason. The actual images that are selected by the session show only if a higher debug level (level 5) is used.

The session log files are located in the following path:

  • UNIX

    /usr/openv/netbackup/vault/sessions/vault_name/sidxxx
    /usr/openv/netbackup/vault/sessions/vault_name/sidxxx/logs

    On a NetBackup cluster, the vault/sessions directory is present in the shared location:

    Example: /opt/VRTSnbu/netbackup/vault/sessions/vault_name/sidxxx/

  • Windows

    install_path\NetBackup\vault\sessions\vault_name\sidxxx

    On a NetBackup cluster, the vault\sessions directory is present in the shared location.

    Example: <shared-path>\NetBackup\vault\sessions\vault_name\sidxxx\

The name of the vault is vault_name and it is used for the session. The unique session identifier xxx is the identifier that Vault assigns to each vault session. The session ID starts at 1 the first time that Vault runs and increments by 1 for each new session. The session identifier for a Vault session can be found by viewing the Activity Monitor entry for that session.

By default, the session log files are created using the following naming convention, on Windows and UNIX platforms.

  • /usr/openv/netbackup/logs/vault/<vault>/<session-id>/logs/<username>.detail.log

  • /usr/openv/netbackup/logs/vault/<vault>/<session-id>/logs/<username>.session.log

For Windows administrative users, the user name ALL_ADMINS gets appended in the log file name. In case of UNIX administrative users, the user name root gets appended in the log file name. For non-administrative users, only for the NBAC, with a specially privileged user in Vault_Operator group who is authorized to run vlteject -report, generates the session logs on demand. For more information on legacy logging, refer to the Legacy Logging section in NetBackup Logging Reference Guide.

Note:

Directory names are not case-sensitive on Microsoft Windows systems. Therefore, session directories are created in the same vault\sessions\vault_name directory for two or more vaults that have names difference only in the letter-case.

Table:  Vault session log names describes the Vault session logs.

Table: Vault session log names

Name

Purpose

duplicate.log.nn

Progress information for duplication operations; generated by the -L option of the bpduplicate command.

preview.list

Summary of images to be duplicated if Duplication step is configured or ejected if Eject step is configured and Duplication step is not.

image.list

Lists all images and partial images for a session.

detail.log

Summary of each action that is performed for a Vault session.

summary.log

Brief description of the Vault session and its results. If email notification is enabled, data in this log file is appended.