Veritas NetBackup™ Troubleshooting Guide

NBCC does the following:

• Queries the EMM database to obtain the primary host name, associated host names, and server attributes for host name normalization

• Through examination of the NetBackup configuration, identifies cluster, application cluster and servers

• Gathers the information on the database and catalog

• Analyzes the consistency of the gathered configuration and database and catalog information

• Creates a packaged bundle for Veritas technical support to review

Veritas recommends that you run NBCC in the following circumstances:

• To check the consistency of the NetBackup configuration and catalog and database information from a tape media perspective

• To gather and create a package bundle when directed to do so by Veritas technical support

The following items can help you run the NBCC utility:

• The use of NBCC without options gathers all data and reports, and is recommended for most customers. For additional information, NBCC description, examples, and instructions for gathering NetBackup catalog and database information to send to technical support, use the NBCC -help command.

• NBCC is designed to be run on NetBackup master servers.

• In some cases, a non-functioning operating system or NetBackup process or service can prevent NBCC from running properly or completing. As NBCC progresses through the interrogation of various operating system or NetBackup components, it outputs what processes to STDOUT. As NBCC processes catalog and database components, it displays how many records have been processed. The number of records that are processed is in direct relationship to the size of the catalog and database being processed. If NBCC detects a failure, related information is output to STDERR. Information to STDOUT or STDERR are also output to the nbcc-info.txt file (if available).

If NBCC does not perform as expected, try the following:

• Use a text editor to look for error notices in the nbcc-info.txt file.

• By default, NBCC sends error messages to standard error (STDERR) and also includes the messages in its output files under the header STDERR.

• If NBCC does not produce adequate information or if it seems to perform incorrectly, run NBCC with the -debug option to include additional debug messages in the nbcc-info.txt file.

• For troubleshooting, run NBCC when the system is in the same state as when the problem occurred. For example, do not stop and restart the NetBackup processes after the error occurs or make a change to the server or network. NBCC may not be able to gather key information about the problem.

The nbcc-info.txt file provides an overview of the environment where NBCC is run, and contains the following:

• General operating system and NetBackup configuration information on the environment that NBCC detects

• A copy of the NBCC processing information that is sent to STDOUT or STDERR.