■ About the analysis utilities for NetBackup debug logs ■ About network troubleshooting utilities
■ About the NetBackup support utility (nbsu)
■ About the NetBackup consistency check utility (NBCC) ■ About the NetBackup consistency check repair (NBCCR) utility ■ About the nbcplogs utility
■ About the robotic test utilities
About NetBackup troubleshooting utilities
Several utilities are available to help diagnose NetBackup problems. The analysis utilities for NetBackup debug logs and the NetBackup support utility (nbsu) are
especially useful in troubleshooting. Table 3-1 Troubleshooting utilities
Description Utility
They enhance NetBackup’s existing debug capabilities by providing a consolidated view of a job debug log.
See“About the analysis utilities for NetBackup debug logs”on page 100.
Analysis utilities for NetBackup debug logs
3
Chapter
Table 3-1 Troubleshooting utilities (continued) Description Utility
They verify various aspects of the network configuration inside and outside NetBackup to ensure that there is no misconfiguration See“About network troubleshooting utilities” on page 104.
Network troubleshooting utilities
It queries the host and gathers appropriate diagnostic information about NetBackup and the operating system.
See“About the NetBackup support utility (nbsu)” on page 105.
NetBackup support utility (nbsu)
It analyzes the integrity of portions of the NetBackup configuration and catalog and database information as they pertain to tape media. See“About the NetBackup consistency check utility (NBCC)”on page 111.
NetBackup consistency check utility (NBCC)
It processes database-catalog repair actions and automates the application of approved suggested repair actions.
See“About the NetBackup consistency check repair (NBCCR) utility”on page 120. NetBackup consistency check repair
(NBCCR) utility
It simplifies the process of gathering logs for deliver to Symantec technical support.
See“About the nbcplogs utility”on page 122.
nbcplogsutility
About the analysis utilities for NetBackup debug logs
The debug log analysis utilities enhance NetBackup’s existing debug capabilities by providing a consolidated view of a job debug log.NetBackup jobs span multiple processes that are distributed across servers. You can get more information about legacy logging and unified logging. See“About logs”on page 127.
To trace a NetBackup job you must view and correlate messages in multiple log files on multiple hosts. The log analysis utilities provide a consolidated view of the job debug logs. The utilities scan the logs for all processes that are traversed or
100 Using NetBackup utilities
run for the job. The utilities can consolidate job information by client, job ID, start time for the job, and policy that is associated with the job.
Table 3-2describes the log analysis utilities. To see the parameters, limitations, and examples of use for each utility, use the command with the-helpoption. All the commands require administrative privileges. The log analysis utilities are available for all platforms that are supported for NetBackup servers.
Note:The utilities must be initiated on supported platforms. However, the utilities can analyze debug log files from most NetBackup client and server platforms for UNIX and Windows.
Table 3-2 Analysis utilities for NetBackup debug logs Description
Utility
Consolidates the debug log messages for specified NetBackup database backup jobs and writes them to standard output. It sorts the messages by time.backupdbtraceattempts to compensate for time zone changes and clock drift between remote servers and clients. At a minimum, you must enable debug logging foradminon the master server, and forbptm
andbpbkaron the media server. For best results, set the verbose logging level to 5 and enable debug logging for the following:bpdbmon the master server andbpcdon all servers in addition to the processes already identified.
A complete description ofbackupdbtraceis in theNetBackup Commands Reference Guide.
backupdbtrace
Copies to standard output the debug log lines relevant to the specified backup jobs, including online (hot) catalog backups.
Thebackuptraceutility can be used for regular file system, database extension, and alternate backup method backup jobs. It consolidates the debug logs for specified NetBackup jobs. The utility writes the relevant debug log messages to standard output and sorts the messages by time.backuptraceattempts to compensate for time zone changes and clock drift between remote servers and clients. The format of the output makes it relatively easy to sort orgrepby timestamp , program name, and server or client name.
Thebackuptraceutility works with thenbpem,nbjm, andnbrblogs on the master server. You should enable debug logging forbpbrmandbptmorbpdmon the media server and for
bpbkaron the client. For best results, set the verbose logging level to 5. Enable debug logging for the following:bpdbmandbprdon the master server and forbpcdon all servers and clients in addition to the processes already identified.
A complete description ofbackuptraceis in theNetBackup Commands Reference Guide.
backuptrace
101 Using NetBackup utilities
Table 3-2 Analysis utilities for NetBackup debug logs (continued) Description
Utility
A helper program forbackuptraceandrestoretrace.It can also be useful as a standalone program and is available for all NetBackup server platforms.
bpgetdebuglogprints to standard output the contents of a specified debug log file. If only the remote machine parameter is specified,bpgetdebuglogprints the following to standard output: the number of seconds of clock drift between the local computer and the remote computer.
A complete description ofbpgetdebuglogis in theNetBackup Commands Reference Guide.
bpgetdebuglog
Consolidates the debug logs for the specified NetBackup duplicate jobs and writes them to standard output. It sorts the messages by time.duplicatetraceattempts to compensate for time zone changes and clock drift between remote servers and clients.
At a minimum, you must enable debug logging foradminon the master server and forbptm
orbpdmon the media server. For best results, set the verbose logging level to 5 and enable debug logging for the following:bpdbmon the master server andbpcdon all servers and clients in addition to the processes already identified.
A complete description ofduplicatetraceis in theNetBackup Commands Reference Guide.
duplicatetrace
Consolidates the debug log messages for the specified NetBackup import jobs and writes them to standard output. It sorts the messages by time.importtraceattempts to compensate for time zone changes and clock drift between remote servers and clients.
At a minimum, you must enable debug logging foradminon the master server. And for
bpbrm,you must enable debug logging for bptmandtaron the media server. For best results, set the verbose logging level to 5 and enable debug logging for the following:
bpdbmon the master server andbpcdon all servers and clients in addition to the processes already identified.
A complete description ofimporttraceis in theNetBackup Commands Reference Guide.
importtrace
102 Using NetBackup utilities
Table 3-2 Analysis utilities for NetBackup debug logs (continued) Description
Utility
Copies to standard output the debug log lines relevant to the specified restore jobs. Therestoretraceutility consolidates the debug logs for specified NetBackup restore jobs. The utility writes debug log messages relevant to the specified jobs to standard output and sorts the messages by time.restoretraceattempts to compensate for time zone changes and clock drift between remote servers and clients. The format of the output makes it relatively easy to sort or grep by timestamp, program name, and server or client name.
At a minimum, you must enable debug logging forbprdon the master server. Enable debug logging forbpbrmandbptmorbpdmon the media server andtaron the client. For best results, set the verbose logging level to 5. Enable debug logging forbpdbmon the master server and forbpcdon all servers and clients.
A complete description ofrestoretraceis in theNetBackup Commands Reference Guide.
restoretrace
Consolidates the debug log messages for the specified verify jobs and writes them to standard output. It sorts the messages by time. Theverifytracecommand attempts to compensate for time zone changes and clock drift between remote servers and clients.
At a minimum, you must enable debug logging as follows: foradminon the master server and forbpbrm,bptm(orbpdm) andtaron the media server. For best results, set the verbose logging level to 5 and enable debug logging for the following:bpdbmon the master server andbpcdon all servers and clients in addition to the processes already identified. A complete description ofverifytraceis in theNetBackup Commands Reference Guide.
verifytrace
The analysis utilities have the following limitations: ■ Media and device management logs are not analyzed.
■ The legacy debug log files must be in standard locations on the servers and clients.
/usr/openv/netbackup/logs/<PROGRAM_NAME>/log.mmddyy
UNIX
install_path/NetBackup/Logs/<PROGRAM_NAME>/mmddyy.log
Windows
An option may be added later that allows the analyzed log files to reside on alternate paths.
Note:For the processes that use unified logging, no log directories must be created.
103 Using NetBackup utilities
■ The consolidated debug log may contain messages from unrelated processes. You can ignore messages with timestamps outside the duration of the job from the following:bprd,nbpem,nbjm,nbrb,bpdbm,bpbrm,bptm,bpdm, andbpcd.
An output line from the log analysis utilities uses the following format: daystamp.millisecs.program.sequence machine log_line
The date of the log that is in the formatyyyymmdd. daystamp
The number of milliseconds since midnight on the local computer. millisecs
The name of program (BPCD, BPRD, etc.) being logged. program
Line number within the debug log file. sequence
The name of the NetBackup server or client. machine
The line that appears in the debug log file. log_line
For more information, see theNetBackup Commands Reference Guide.