backuptrace

backuptrace — consolidate the debug logs for a NetBackup job

SYNOPSIS

<admin_dir_path>backuptrace [-master_server name] [-job_id number] [-birth_time number] [-policy_name name] [-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 backuptrace utility consolidates the debug logs for specified NetBackup job or jobs. The debug log messages relevant to the specified backup jobs are written to standard output. Then the messages sort by time. The backuptrace utility tries to compensate for time zone changes and the clock drift between remote servers and clients. The output is formatted so that you can more easily sort or group by timestamp, program name, server name, or client name.

At a minimum, you must enable debug logging for the following:

  • nbjm on the master server

  • bpbrm, bptm, and bpdm on the media server

  • bpbkar on the client

For best results, set the verbose logging level to 5 and enable debug logging for the following in addition to the processes already identified:

  • bpdbm and bprd on the master server

  • bpcd on all servers and clients

Use the backuptrace utility for regular file system, database extension, and alternate backup method backup jobs.

OPTIONS

-master_server name

Name of the master server. Default is the local host name.

-job_id number

Job ID number of the backup job to analyze.

-birth_time number

Birth time (seconds since 1970) of the backup job to analyze.

-policy_name name

Policy name of the jobs 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. This option identifies the log file names (log.mmddyy for UNIX, mmddyy.log for Windows) to analyze.

NOTES

Media Manager logs are not analyzed.

EXAMPLES

C:\Program Files\VERITAS\NetBackup\bin\admincmd\backuptrace 
policy weekly_bkups 051205 >/tmp/jobs.weekly_bkups

Use this utility to consolidate logs for all jobs that are started for the policy weekly_bkups on the specified date. Use the -start_time/-end_time arguments to limit the window for which the jobs are to be evaluated.