Veritas NetBackup™ Appliance Troubleshooting Guide

Last Published:
Product(s): Appliances (3.0)
  1. About using the Troubleshooting Guide
    1.  
      About this guide
    2.  
      About the intended audience
    3.  
      About contacting Technical Support
    4.  
      About troubleshooting the NetBackup Appliance
  2. Best practices
    1.  
      About best practices
    2.  
      Determining the NetBackup Appliance serial number
    3.  
      About Fibre Channel HBA card configuration verification
    4.  
      About Notification settings
    5.  
      About IPMI configuration
    6.  
      About password management and recovery
    7.  
      About IPv4-IPv6-based network support
    8.  
      About enabling BMR options
    9.  
      About deleting users
  3. About troubleshooting tools
    1.  
      Tools for troubleshooting the NetBackup Appliance
    2.  
      About hardware monitoring
    3.  
      Troubleshooting and tuning appliance from the Appliance Diagnostics Center
    4. About NetBackup support utilities
      1.  
        NetBackup Domain Network Analyzer (NBDNA)
      2.  
        NetBackup Support Utility (NBSU)
  4. Working with log files
    1.  
      About NetBackup Appliance log files
    2.  
      About the Collect Log files wizard
    3.  
      Viewing log files using the Support command
    4.  
      Where to find NetBackup Appliance log files using the Browse command
    5.  
      Gathering device logs with the DataCollect command
    6.  
      About gathering information for NetBackup-Java applications
    7.  
      Enabling and disabling VxMS logging
  5. Disaster recovery
    1.  
      About disaster recovery
    2.  
      Disaster recovery best practices
    3. Disaster recovery scenarios
      1. Appliance sustained power interruption
        1.  
          Restoring operation to a NetBackup Appliance following a power outage
        2.  
          Restoring operation to a NetBackup Appliance with external storage following a power outage
      2. Appliance hardware failure
        1.  
          Removing and replacing hardware components
        2.  
          Setting a NetBackup 5330 storage shelf component to the Service Allowed mode
      3.  
        Complete loss of appliance with recoverable operating system drives and attached storage disks
      4. Complete loss of appliance with recoverable attached storage disks
        1.  
          Reimaging a NetBackup appliance from the USB drive
        2.  
          Reconfiguring a 52xx master server appliance using the NetBackup Appliance Shell Menu
        3.  
          Configuring a master server to communicate with an appliance media server
        4.  
          Reconfiguring a 52xx or 5330 media server appliance using the NetBackup Appliance Shell Menu
        5.  
          About NIC1 (eth0) port usage on NetBackup appliances
      5.  
        Complete loss of appliance and attached storage disks
      6.  
        NetBackup Appliance software corruption
      7. NetBackup Appliance database corruption
        1.  
          Rollback to an appliance checkpoint from the appliance shell menu
        2.  
          About appliance rollback validation
      8. NetBackup Appliance catalog corruption
        1.  
          Starting a factory reset from the appliance shell menu
      9.  
        NetBackup Appliance operating system corruption
  6. NetBackup Appliance error messages
    1.  
      About NetBackup Appliance error messages
    2.  
      Error messages displayed during initial configuration
    3.  
      Error messages displayed on the NetBackup Appliance Web Console
    4.  
      Error messages displayed on the NetBackup Appliance Shell Menu
    5.  
      NetBackup status codes applicable for NetBackup Appliance

Troubleshooting and tuning appliance from the Appliance Diagnostics Center

You can troubleshoot multiple failures and resolve issues in the NetBackup appliance by using some interactive self-repair wizards in the Appliance Diagnostics Center. Each wizard helps you perform specific diagnostic tasks. Some of the wizards also guide you through system optimization and tuning. These wizards can be accessed by clicking the Appliance Diagnostics Center icon on the NetBackup Appliance Web Console. The icon is located on the upper-right corner of the NetBackup Appliance Web Console and looks like the following:

Appliance Diagnostics Center

When you click this icon, the Appliance Diagnostics Center page appears where you can see the Available and the Running Wizard Jobs tab. You can return to the NetBackup Appliance Web Console by closing this page.

All the troubleshooting wizards are listed under the Available tab.

The Running Wizard Jobs tab lists the wizards that were started but are not complete yet. If you close a wizard without completing it (using the cross icon) or leave it unfinished, it is listed under the Running Wizard Jobs tab. You can resume or delete these active wizards by clicking the respective icons from the Resume or Delete columns.

You can do the following to run the wizards from the Available tab:

Click Collect Log files

Use this wizard to collect log files from an Appliance.

The wizard lets you collect different types of log files like NetBackup, Appliance, operating system, PureDisk, GUI, NBSU (NetBackup Support Utility), DataCollect etc. Note that it may take several minutes to collect the NetBackup logs.

Table: Log files collected by the Collect Logs Wizard lists details about the log files that are collected by the wizard.

You can choose to email the log files to recipients, download to your computer, or upload them to Veritas Support.

Review the following points if you want to email the log files:

  • SMTP must be configured for emailing the logs. You can configure SMTP from Settings > Notification > Alert Configuration in the NetBackup Appliance Web Console.

  • To email the logs, the collected log size must be 10 MB or less.

Table: Log files collected by the Collect Logs Wizard lists the log files that are collected by the Collect Log Files Wizard. The logs are collected based on the log type that you specify. If you are collecting NetBackup logs, you can also specify the time frame for which you want to collect the logs.

Table: Log files collected by the Collect Logs Wizard

Log Type

What is collected?

NetBackup

Logs created by the NetBackup Copy Logs tool (nbcplogs). These include the following:

  • NetBackup legacy logs

  • NetBackup VxUL (Unified) logs

  • NetBackup OpsCenter logs

  • NetBackup PureDisk logs

  • Windows Event logs (Application, System, Security)

  • PBX logs

  • NetBackup database logs

  • NetBackup database error logs

  • NetBackup database trylogs

  • Vault session logs

  • Volume Manager debug logs

  • VxMS logs, if enabled

Note:

The legacy logs and the VXlogs are collected based on the time frame that you specify.

Appliance

Appliance logs including upgrade, hardware, event logs and so on. The following Appliance logs are collected:

  • hostchange.log, selftest_report*

  • Logs created by the CallhomeDataGather utility.

  • config_nb_factory.log, iso_postinstall.log, sf.log

  • patch_*, upgrade_* logs

  • NetBackup Appliance VxUL (Unified) logs, which include:

    • All

    • CallHome

    • Checkpoint

    • Common

    • Config

    • Database

    • Hardware

    • HWMonitor

    • Network

    • RAID

    • Seeding

    • SelfTest

    • Storage

    • SWUpdate

    • Commands

    • CrossHost

    • Trace

    Note:

    The NetBackup Appliance unified logs are not the same as the NetBackup unified logs, such as nbpem or nbjm. NetBackup Appliance has its own set of unified logs. To collect the NetBackup unified logs, select NetBackup in the Collect Logs Wizard.

Operating system

Operating system logs that include the following:

  • boot.log

  • boot.msg

  • boot.omsg

  • messages

Deduplication (Media Server Deduplication Pool or PureDisk)

All logs related to Media Server Deduplication Pool (MSDP) are collected under the following directories:

<DIR> PD

  • /var/log/puredisk

  • /msdp/data/dp1/pdvol/log

NetBackup Appliance Web Console

All logs related to NetBackup Appliance Web Console logs are collected under the following directories:

/log/webgui

NetBackup support utility (nbsu)

Diagnostic information about NetBackup and the operating system.

DataCollect

Hardware and storage device logs. The logs created by the DataCollect utility are collected.