DOCUMENTATION: The command line equivalents for running the NetBackup reports available in the NetBackup user interface

Article:TECH20462  |  Created: 2009-01-25  |  Updated: 2013-10-24  |  Article URL http://www.symantec.com/docs/TECH20462
Article Type
Technical Solution


Environment

Issue



DOCUMENTATION: The command line equivalents for running the NetBackup reports available in the NetBackup user interface

Solution



Manual:

VERITAS NetBackup (tm) 5.0 System Administrator's Guide, Volume I for UNIX
VERITAS NetBackup (tm) 5.1 System Administrator's Guide, Volume I for UNIX
VERITAS NetBackup (tm) 6.0 System Administrator's Guide, Volume I for UNIX
VERITAS NetBackup (tm) 6.5 System Administrator's Guide, Volume I for UNIX


Page:  n/a

Modification Type:  Supplement

Modification:

This is a list of the command line tools that run the same reports as the NetBackup (tm) GUI.

Command Line Interface for NetBackup Reports
Note:
<start_date> and <end_date> syntax: MM/DD/YY
<start_time> and <end_time> syntax: hh:mm:ss
<media_id> is the six-character media identification number

Backup Status Report
The Backup Status report shows status and error information on jobs completed within the specified time period. If an error has occurred, a short explanation of the error is included.  
# cd /usr/openv/netbackup/bin/admincmd
# ./bperror -U -backstat -s info [-d <start_date> <start_time> -e <end_date> <end_time>]

Client Backups Report
The Client Backups report shows detailed information on backups completed within the specified time period.  
# cd /usr/openv/netbackup/bin/admincmd
# ./bpimagelist -U [-A|-client name] [-d <start_date> <start_time> -e <end_date> <end_time>]

Problems Report
The Problems report lists the problems that the server has logged during the specified time period. This information is a subset of the information you get from the All Log Entries report.
# cd /usr/openv/netbackup/bin/admincmd
# ./bperror -U -problems [-d <start_date> <start_time> -e <end_date> <end_time>]

All Log Entries Report
The All Log Entries report lists all log entries for the specified time period. This report includes the information from the Problems report and Media Log Entries report. This report also shows the transfer rate, which is useful in determining and predicting rates and backup times for future backups (the transfer rate does not appear for multiplexed backups).  
# cd /usr/openv/netbackup/bin/admincmd
# ./bperror -U -all [-d <start_date> <start_time> -e <end_date> <end_time>]

Media List Report
The Media Lists report shows information for volumes that have been allocated for backups. This report does not show media for Disk type storage units or for backups of the NetBackup catalogs.
# cd /usr/openv/netbackup/bin/admincmd
# ./bpmedialist -U -mlist [-m <media_id>

Media Contents Report
The Media Contents report shows the contents of a volume as read directly from the media header and backup headers. This report lists the backup IDs (not each individual file) that are on a single volume. If a tape has to be mounted, there will be a longer delay before the report appears.
# cd /usr/openv/netbackup/bin/admincmd
# ./bpmedialist -U -mcontents [-m <media_id>]

Images on Media Report
The Images on Media report lists the contents of the media as recorded in the NetBackup image catalog. You can generate this report for any type of media (including disk) and filter it according to client, media ID, or path.
# cd /usr/openv/netbackup/bin/admincmd
# ./bpimmedia -U [-client <client_name>] [-mediaid <media_id>]

Media Log Entries Report
The Media Logs report shows media errors or informational messages that are recorded in the NetBackup error catalog. This information also appears in the All Log Entries report.
# cd /usr/openv/netbackup/bin/admincmd
# ./bperror -U -media [-d <start_date> <start_time> -e <end_date> <end_time>]

Media Summary Report
The Media Summary report summarizes active and non-active volumes for the specified server according to expiration date. It also shows how many volumes are at each retention level. In verbose mode, the report shows each media ID and its expiration date.
# cd /usr/openv/netbackup/bin/admincmd
# ./bpmedialist -summary

Media Written Report
The Media Written report identifies volumes that were used for backups within the specified time period.  
# cd /usr/openv/netbackup/bin/admincmd
# ./bpimagelist -A -media [-d <start_date> <start_time> -e <end_date> <end_time>]

Volume detail (vmquery)
There is no NetBackup GUI equivalent for the Volume detail report. This is a command line method to get details for all tapes or a specific tape.  This can be used as a complement to other Media reports.
# cd /usr/openv/volmgr/bin
# ./vmquery -a
or
# ./vmquery -m <media_id>

Refer to the NetBackup System Administrator's Guide for further information on these commands and for a description of the columns and their meanings.
  • Pages 200 to 209 in the NetBackup DataCenter 4.5 System Administrator's Guide for UNIX
  • Pages 261 to 272 in the VERITAS NetBackup (tm) 5.0 System Administrator's Guide, Volume I for UNIX
  • Pages 263 to 274 in the VERITAS NetBackup (tm) 5.1 System Administrators Guide for UNIX, Volume I
  • Page 304 to 316 in the VERITAS Netbackup (tm) 6.0 System Administrators Guide for UNIX Volume 1
  • Page 76 to 80 in the VERITAS Netbackup (tm) 6.5 System Administrators Guide for UNIX Volume 1
  • VERITAS NetBackup (tm) 5.1 Command Reference for UNIX
  • VERITAS NetBackup (tm) 6.5 Commands for UNIX and Linux
  • VERITAS NetBackup (tm) 6.0 Commands for UNIX  
·



Legacy ID



247902


Article URL http://www.symantec.com/docs/TECH20462


Terms of use for this information are found in Legal Notices