Veritas NetBackup™ Commands Reference Guide
- Introduction
- Appendix A. NetBackup Commands
Name
restoretrace — consolidate debug logs for a restore job
SYNOPSIS
[-master_server name] [-job_id number] [-client_name name] [-start_time hh:mm:ss] [-end_time hh:mm:ss] mmddyy [mmddyy...]
On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/admincmd/
On Windows systems, the directory path to this command is install_path\NetBackup\bin\admincmd\
DESCRIPTION
The restoretrace utility consolidates the debug logs for the specified restore jobs. It copies to standard output the debug log lines relevant to the specified restore jobs. The messages sort by time. The utility tries to compensate for time zone changes and clock drift between remote servers and clients. The output is formatted to easily sort or group by timestamp, program name, server, or function for the following: bprd on the master server, bpbrm and bptm-bpdm on the media server, and tar on the client. For best results, set the verbose logging level to 5. Enable debug logging for bpdbm on the master server and for bpcd on all servers and clients in addition to already identified processes.
You must have administrator privileges to run this command.
OPTIONS
- -master_server name
Name of the master server. Default is the local host name.
- -job_id number
Job ID number of the restore job to analyze.
- -client_name name
Client name of the jobs to analyze.
- -start_time hh:mm:ss
Earliest timestamp to start analyzing the logs.
- -end_time hh:mm:ss
Latest timestamp to finish analyzing the logs.
- mmddyy [mmddyy...]
One or more day stamps that identify the log file names (
log.mmddyy
for UNIX, andmmddyy.log
for Windows) that restoretrace analyzes.
NOTES
Media Manager logs are not analyzed.
EXAMPLES
Example 1 - Consolidate debug logs of all the restore jobs for the client peony on 071502. Use the start_time and end_time parameters to limit the window for the jobs that are evaluated.
UNIX systems:
/usr/openv/netbackup/bin/admincmd/restoretrace -job_id 234 081302 log.234
Windows systems:
C:\Program Files\VERITAS\NetBackup\bin\admincmd\restoretrace client peony install_path C:\Program Files\VERITAS 071502 log.peony