Backup Reports Automation

Document ID: 247902

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>]

bpimagelist -A -l -media -d 09/27/2006 08:00:00 -e 09/28/2006 08:00:00

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

Hope this helps.

Regards