restoretrace

restoretrace — consolidate debug logs for a restore job

SYNOPSIS

<admin_dir_path>restoretrace [-master_server name] [-job_id number] [-client_name name] [-start_time hh:mm:ss] [-end_time hh:mm:ss] mmddyy [mmddyy ...]

On Windows systems, <admin_dir_path> 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 and Linux, and mmddyy.log for Windows) that are analyzed.

NOTES

Media Manager logs are not analyzed.

EXAMPLES

Windows systems:

C:\Program Files\VERITAS\NetBackup\bin\admincmd\restoretrace 
client peony install_path C:\Program Files\VERITAS 071502 
log.peony

When you initiate the utility, it consolidates debug logs for all the restore jobs for the client peony on 071502. Use the start_time/end_time arguments to limit the window for the jobs are to be evaluated.