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

About gathering information for NetBackup-Java applications

If you encounter problems with the NetBackup-Java applications, use the following methods to gather data for support.

The following scripts are available for gathering information:

jnbSA

(NetBackup-Java administration application startup script)

Logs the data in a log file in /usr/openv/netbackup/logs/user_ops/nbjlogs. At startup, the script tells you which file in this directory it logs to. Normally, this file does not become very large (usually less than 2 KB). Consult the file /usr/openv/java/Debug.properties for the options that can affect the contents of this log file.

NetBackup-Java administration application on Windows

If NetBackup is installed on the computer where the application was started, the script logs the data in a log file at install_path\NetBackup\logs\user_ops\nbjlogs.

If NetBackup was not installed on this computer, then no log file is created. To produce a log file, modify the last "java.exe" line in the following to redirect output to a file: install_path\java\nbjava.bat.

If NetBackup was not installed on this computer, the script logs the data in a log file at install_path\Veritas\Java\logs.

Note:

When NetBackup is installed where the application is started, and when install_path is not set in the setconf.bat file, the script logs the data here: install_path\Veritas\Java\logs.

/usr/openv/java/get_trace

UNIX/Linux only.

Provides a Java Virtual Machine stack trace for support to analyze. This stack trace is written to the log file that is associated with the instance of execution.

UNIX/Linux:

/usr/openv/netbackup/bin/support/nbsu

Windows:

install_path\NetBackup\bin\support\
nbsu.exe

Queries the host and gathers appropriate diagnostic information about NetBackup and the operating system.

The following example describes how you can gather troubleshooting data for Veritas Technical Support to analyze.

An application does not respond.

Wait for several minutes before you assume that the operation is hung. Some operations can take quite a while to complete, especially operations in the Activity Monitor and Reports applications.

UNIX/Linux only:

Still no response after several minutes.

Run /usr/openv/java/get_trace under the account where you started the Java application. This script causes a stack trace to write to the log file.

For example, if you started jnbSA from the root account, start /usr/openv/java/get_trace as root. Otherwise, the command runs without error, but fails to add the stack trace to the debug log. This failure occurs because root is the only account that has permission to run the command that dumps the stack trace.

Get data about your configuration.

Run the nbsu command that is listed in this topic. Run this command after you complete the NetBackup installation and every time you change the NetBackup configuration.

Contact Veritas Technical Support

Provide the log file and the output of the nbsu command for analysis.