Veritas NetBackup™ Commands Reference Guide
- Introduction
- Appendix A. NetBackup Commands
Name
verifytrace — trace debug logs for verify jobs
SYNOPSIS
[-master_server name] -job_id number [-start_time hh:mm:ss] [-end_time hh:mm:ss] mmddyy [mmddyy _]
[-master_server name] -backup_id id [-start_time hh:mm:ss] [-end_time hh:mm:ss] mmddyy [mmddyy _]
[-master_server name] [-policy_name name] [-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 verifytrace command consolidates the debug log messages for the specified verify jobs and writes them to standard output. The messages sort by time. verifytrace tries to compensate for time zone changes and clock drift between remote servers and clients.
At a minimum, you must enable debug logging for the following:
UNIX systems: The
/usr/openv/netbackup/admin
directory on the master serverWindows systems: The
install_path\NetBackup\bin\admin
directory on the master serverThe bpbrm, bptm/bpdm, and tar commands on the media server
For best results, set the verbose logging level to 5. Enable debug logging for bpdbm on the master server and bpcd on all servers and clients in addition to already identified processes.
If you specify either -job_id or -backup_id, verifytrace uses this option as the sole criteria to select the verify jobs it traces. You cannot use the options -policy_name or -client_name with -job_id or -backup_id. If you do not specify -job_id or -backup_id, verifytrace selects all the verify jobs that match the specified selection criteria. If none of the following options is specified, verifytrace traces all the jobs that ran on the days that the day stamps (mmddyy) specify: -job_id, -backup_id, -policy_name, or -client_name. If -start_time/-end_time options are used, the debug logs on the specified time interval are examined.
If verifytrace is started with -backup_id id, it looks for a verify job that bpverify started with -backup_id id where the backup IDs (id) match.
If verifytrace is started with -policy_name name, it looks for a verify job that bpverify started with -policy_name name where the policy names (name) match.
If verifytrace is started with -client_name name, it looks for a verify job that bpverify started with -client_name name where the client names (name) match.
verifytrace writes error messages to standard error.
You must have administrator privileges to run this command.
OPTIONS
- -master_server
Name of the master server. Default is the local host name.
- -job_id
Job ID number of the verify job to analyze. Default is any job ID.
- -backup_id
Backup ID number of the backup image that the verify job verified to analyze. Default is any backup ID.
- -policy_name
Policy name of the verify jobs to analyze. Default is any policy.
- -client_name
Client name of the verify jobs to analyze. Default is any client.
- -start_time
Earliest timestamp to start analyzing the logs. Default is 00:00:00
- -end_time
Latest timestamp to finish analyzing the logs. Default is 23:59:59.
- mmddyy
One or more "day stamps". This option identifies the log file names (log.mmddyy for UNIX, mmddyy.log for Windows) that are analyzed.
OUTPUT FORMAT
The format of an output line is: daystamp.millisecs.program.sequence machine log_line
- daystamp
The day of the log is created in yyyymmdd format.
- millisecs
The number of milliseconds since midnight on the local computer.
- program
The name of program (ADMIN, BPBRM, BPCD, etc.) being logged.
- sequence
Line number within the debug log file.
- machine
The name of the NetBackup server or client.
- log_line
The line that appears in the debug log file.
EXAMPLES
Example 1 - Analyze the log of verify job with job ID 2 that ran on August 6, 2011.
# verifytrace -job_id 2 080611
Example 2 - Analyzes the verify jobs log that verify backup images with backup ID pride_1028666945, which ran on 20th August 2011. This command only analyzes those verify jobs that ran with option -backupid pride_1028666945.
# verifytrace -backup_id pride_1028666945 082011
Example 3 - Analyzes the verify jobs log that ran on policy Pride-Std and client pride on August 16, 2011 and August 23, 2011. This command only analyzes those verify jobs that ran with options -policy Pride-Std and -client pride.
# verifytrace -policy_name Pride-Std -client_name pride 081611 082311
Example 4 - Analyzes the verify jobs log that ran on August 5, 2011 and August 17, 2011.
# verifytrace 080511 081711