Veritas NetBackup™ Commands Reference Guide
- Appendix A. NetBackup Commands
importtrace — trace debug logs for import jobs
[-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\
importtrace consolidates the debug log messages for the specified import job[s] and writes them to standard output. The messages sort by time. importtrace tries to compensate for time zone changes and clock drift between remote servers and clients.
At a minimum, enable debug logging for bpbrm, bptm, and nbtar on the media server and for the following directory on the master 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 the processes already identified.
duplicatetrace uses the -job_id or -backup_id option as the sole criteria for selecting the duplicate jobs it traces. The -policy_name option or the -client_name option cannot be used with -job_id or -backup_id. If neither option is specified, then all duplicate jobs that match the selection criteria are selected. If none of the following options are specified, all the duplicate jobs that are activated on the days that day stamps (mmddyy) specify are traced: -job_id, -backup_id, -policy_name, or -client_name. If -start_time and -end_time options are used, then importtrace examines the debug logs that are generated in the specified time interval.
If importtrace starts with -backup_id id, it looks for the import jobs that bpimport started with -backup_id id where the backup IDs (id) match.
If importtrace starts with -policy_name <policy>, importtrace looks for the import jobs that started with bpimport with -policy <policy> where the policy names (<policy>) match.
If importtrace starts with -client_name <client>, importtrace looks for the import jobs that started with bpimport with -client <client> where the client names (<client>) match.
importtrace writes error messages to standard error.
You must have administrator privileges to run this command.
Name of the master server. Default is the local host name.
Job ID number of the import job to analyze. Default is any job ID.
Backup ID number of the backup image that the import job imports to analyze. Default is any backup ID.
Policy name of the import jobs to analyze. Default is any policy.
Client name of the import jobs to analyze. Default is any client.
Earliest timestamp to start analyzing the logs. Default is 00:00:00.
Latest timestamp to finish analyzing the logs. Default is 23:59:59.
One or more day stamps. This option identifies the log file names (log.mmddyy for UNIX, mmddyy.log for Windows) to be analyzed.
The format of an output line is:
<daystamp>.<millisecs>.<program>.<sequence> <machine> <log_line>
The day of the log displayed in yyyymmdd format.
The number of milliseconds since midnight on the local computer.
The name of program (ADMIN, BPBRM, BPCD, etc.) being logged.
Line number within the debug log file.
The name of the NetBackup server or client.
The line that appears in the debug log file.
Example 1 - Analyze the log of import job with job ID 4 activated on August 6, 2009.
# importtrace -job_id 4 080609
Example 2 - Analyze the log of import jobs that import backup image with backup ID pride_1028666945 executed on August 20, 2009. This command would analyze only those import jobs, which were activated with option -backupid pride_1028666945.
# importtrace -backup_id pride_1028666945 082009
Example 3 - Analyze the log of import jobs that are activated on policy Pride-Standard and client pride on August 16, 2009 and August 23, 2009. This command would analyze only those import jobs, which were activated with options -policy Pride-Standard and -client pride.
# importtrace -policy_name Pride-Standard -client_name pride 081609 082309
Example 4 - Analyze the log of all import jobs that are activated on August 5, 2015 and August 17, 2015.
# importtrace 080515 081715