Veritas NetBackup™ for Enterprise Vault™ Agent Administrator's Guide

Last Published:
Product(s): NetBackup (9.0.0.1, 9.0)
  1. Introduction to NetBackup Enterprise Vault
    1.  
      About Enterprise Vault
    2.  
      About the NetBackup Enterprise Vault Agent
    3.  
      About the Enterprise Vault Agent and the backup components
    4.  
      Enterprise Vault agent features
    5.  
      Enterprise Vault agent requirements
  2. About NetBackup Enterprise Vault agent installation requirements
    1.  
      Installation requirements for NetBackup Enterprise Vault agent
    2.  
      Verifying Enterprise Vault agent operating system compatibility
    3.  
      NetBackup server and client software requirements
    4.  
      About Enterprise Vault agent installation requirements in a cluster
    5.  
      Configuring Enterprise Vault Agent to protect Enterprise Vault databases
    6.  
      Adding the Enterprise Vault agent license key
  3. Configuration
    1.  
      About the Windows and Java user interfaces
    2.  
      Specifying a logon account for the Enterprise Vault server
    3.  
      About VSS-based snapshot configuration
    4.  
      Configuring the local media server for Enterprise Vault backup
    5.  
      Configuration requirements for an Enterprise Vault backup policy
    6.  
      Adding a new Enterprise Vault policy
    7.  
      Enterprise Vault backup policy attributes
    8.  
      Adding schedules to an Enterprise Vault policy
    9.  
      About the types of Enterprise Vault backups
    10.  
      Creating a backup selections list
    11.  
      Adding a client to a policy
  4. About features provided by Enterprise Vault for a backup provider
    1.  
      About Enterprise Vault quiescence before a backup
    2.  
      About quiescing and unquiescing Enterprise Vault services
    3.  
      About granular quiescence
    4.  
      About managing safety copies and backups
    5.  
      About the partition secure notification file
    6.  
      About the archive bit
  5. Performing backups of Enterprise Vault
    1.  
      About Enterprise Vault directives and what data they back up
    2.  
      Manually backing up Enterprise Vault resources
    3.  
      Canceling an Enterprise Vault backup job from the Activity Monitor
  6. Performing restores of Enterprise Vault
    1.  
      Important notes about Enterprise Vault data restore
    2.  
      Stopping the administrative services on Enterprise Vault servers
    3.  
      About the Backup, Archive, and Restore interface
    4.  
      Viewing backup data using the Microsoft SQL Server Management Studio
    5.  
      Restoring Enterprise Vault data
    6.  
      About the Enterprise Vault restore options on the General tab
    7.  
      About the Enterprise Vault Database Settings tab
    8.  
      Specifying the server, clients, and policy type for restores
    9.  
      About restoring Enterprise Vault file system data
    10.  
      Restoring an Enterprise Vault file system component
    11. About restoring Enterprise Vault SQL databases
      1.  
        About backup image restore sets
    12.  
      Restoring Enterprise Vault SQL database components
  7. Disaster recovery
    1.  
      Disaster recovery requirements for Enterprise Vault server
    2.  
      About disaster recovery of an Enterprise Vault site
    3.  
      Recovering a directory database
    4.  
      Recovering an auditing database
    5.  
      Recovering an FSA Reporting database
    6.  
      Recovering a Monitoring database
    7.  
      Recovering index locations
    8.  
      Recovering an Enterprise Vault vault store group
    9.  
      Recovering a fingerprint database
    10.  
      Recovering a vault store database
    11.  
      Recovering vault store partition
    12.  
      Recovering Enterprise Vault partitions
    13.  
      Recovering an Enterprise Vault server
    14.  
      Recovering an Enterprise Vault server on a different system
  8. Enterprise Vault Agent support for Enterprise Vault
    1. Policy configuration for Enterprise Vault
      1.  
        Open partition, vault store database, and fingerprint database consistencies
      2.  
        Closed and ready partition consistencies
      3.  
        Index location consistencies
      4.  
        Directory database consistencies
    2. Notes about Enterprise Vault 10.0 backups
      1.  
        Exclude file list for index locations
      2.  
        Exclude file list for vault partitions
    3.  
      Excluding files from the exclude list
    4.  
      About planning backup schedules
    5.  
      About hosts for Enterprise Vault policies
    6.  
      About Enterprise Vault tools
    7. About Enterprise Vault agent backups
      1.  
        Privileges for Enterprise Vault backup
    8. About Enterprise Vault agent restores
      1.  
        Changing the socket buffer size for large restores
    9.  
      Useful tips about Enterprise Vault agent
    10. Enterprise Vault agent functionality and support for Enterprise Vault
      1.  
        Differential incremental backup taken after a restore fails for Enterprise Vault
  9. Troubleshooting
    1.  
      About troubleshooting
    2.  
      About debug logging
    3.  
      How to enable debug logging
    4.  
      Setting the debug level
    5.  
      About status reports
    6.  
      About operational reports
    7.  
      About progress reports
    8. About NetBackup status-related troubleshooting information
      1.  
        NetBackup status code 2
      2.  
        NetBackup status code 13
      3.  
        NetBackup status code 39
      4.  
        NetBackup status code 59
      5.  
        NetBackup status code 69
      6. NetBackup status code 156
        1.  
          About the VSS_E_BAD_STATE snapshot error
        2.  
          About the VSS_E_INSUFFICIENT_STORAGE snapshot error
      7.  
        NetBackup status code 1800
  10. Appendix A. NetBackup Enterprise Vault Migrator
    1.  
      About the Enterprise Vault Migrator
    2.  
      About configuring a backup policy for migration
    3.  
      About configuring Enterprise Vault for collection and migration
    4.  
      Testing the Enterprise Vault migrator configuration
    5.  
      Setting the recommended DCOM settings
    6. Restoring Enterprise Vault migrated data from NetBackup
      1.  
        Restoring migrated data using the command line interface
      2.  
        Restoring migrated data using a Backup, Archive, and Restore user interface
    7. Troubleshooting the Enterprise Vault migrator
      1.  
        Enterprise Vault migrator version information
      2. About troubleshooting issues with the migrator
        1.  
          Is the data being archived?
        2.  
          Is the data being collected?
        3.  
          Is the migration being configured appropriately?
        4.  
          Is the data being migrated?
      3. About Log Collection
        1.  
          About Enterprise Vault logs
        2.  
          About Enterprise Vault events
        3.  
          About NetBackup logs
  11.  
    Index

About NetBackup logs

The NetBackup Enterprise Vault migrator communicates to NetBackup through the VxBSA module, and the VxBSA logs are the logs that you must collect from NetBackup. Each NetBackup backup takes place through the bpbkar process. The restore takes place through a tar process. Thus, it is important that you collect the logs for both these processes.

Note:

Use the following procedure as a guideline only. Even though the objectives that are stated within the procedure remain the same, the steps to achieve them may vary with different versions of NetBackup. The same principle also applies to the screen shots provided.

In case of any believed discrepancy, see the NetBackup Troubleshooting Guide UNIX, Windows, Linux for more information.

To collect the Enterprise Vault logs that were migrated to the NetBackup logs

  1. Go to the NetBackup logs directory.

    A logs directory resides under the NetBackup installed directory. For example, if NetBackup is installed under the directory, C:\Program Files\Veritas\NetBackup\, then the following logs directory also exists:

    C:\Program Files\Veritas\NetBackup\logs

  2. Create the required directories under the NetBackup logs folder.

    You should refer to the following logs as your first point of reference when you investigate the details of any failure:

    • vxbsa logs

    • bpbkar logs

    • tar logs

    To enable the creation of these log files you must create the following directories under the NetBackup logs folder (if they do not already exist):

    • exten_client

      Executing the mklogdir.bat command creates several log directories. However, this command does not create the directory, exten_client.

    • bpbkar

    • tar

    The migration can fail because of any failure in the workings of NetBackup. Therefore, even though the first point of investigation should start with the mentioned logs, it is safest to collect all of the logs by executing the command, mklogdir.bat.

  3. Set the NetBackup logging level to the required level.

    You should update the logging level of the NetBackup client through which the migration takes place. Ideally, you should set the logging level to the highest level. You configure the client in the profile through which the migration takes place (for example, EV_Default_Profile).

    You can update the logging level using the Client Properties dialog on either the NetBackup Administration Console or the Backup, Archive, and Restore user interface.

    From the Client Properties dialog on the Backup, Archive, and Restore user interface, you can configure the Debug logging levels on the Troubleshooting tab. Use the following recommended values:

    • General: 2

    • Verbose: 5

  4. Execute the migrator tasks for which logs are required.
  5. Collect log files.

    Collect the latest files under the following directories:

    • exten_client

    • bpbkar

    • tar

      You should collect all the logs files by either creating a .zip file of the NetBackup logs folder, or copying the latest file under every directory under the NetBackup logs folder.