|
|
<admin_dir_path>bpverify [-l] [-p] [-pb] [-v] [-local] [-client name] [-st sched_type] [-sl sched_label] [-L output_file [-en]] [-policy name] [-s date] [-e date] [-M master_server] [-Bidfile file_name] [-pt policy_type] [-hoursago hours] [[-cn copy number] | [-primary]] [-backupid backup_id] [[-id media_id or path] | [-stype server_type] [-dp disk_pool_name [-dv disk_volume]]] [-priority number]
bpverify verifies the contents of one or more backups by reading the backup volume and by comparing its contents to the NetBackup catalog. This operation does not compare the data on the volume with the contents of the client disk. However, it does read each block in the image, which verifies that the volume is readable. NetBackup verifies only one backup at a time and tries to minimize media mounts and position time.
If either -Bidfile or -backupid is specified, bpverify uses this option as the sole criterion for selecting the set of backups it verifies. If the command line does not contain -Bidfile or -backupid, then bpverify selects the backups that satisfy all the selection options. For instance, if the command line looks like:
bpverify -pt Standard -hoursago 10
then bpverify verifies the set of backups with policy type Standard that have been run in the past 10 hours.
If -p or -pb is specified, bpverify previews the set of backups that meet the selection criteria. In this case, bpverify displays the backup IDs, but does not perform the verification.
bpverify sends its error messages to stderr. bpverify sends a log of its activity to the NetBackup admin log file for the current day, which are found the following directory:
Windows systems: install_path\NetBackup\Logs\admin
Any authorized user can run this command.
For more information about NetBackup authorization, refer to the NetBackup Security and Encryption Guide.
Specifies the backup ID of a single backup to verify. This option takes precedence over any other selection criteria except -Bidfile. The default is any backup.
file_name specifies a file that contains a list of backup IDs to be verified. In addition, this file is removed during the activation of that command line interface (CLI). This file is removed because the NetBackup GUIs commonly use this parameter. The GUIs expect the command-line interface to remove the temporary file that was used for the -Bidfile option upon completion. Direct command-line interface users can also use the option, however it removes the file.
The file contains one backup ID per line. If this option is specified, other selection criteria are ignored. The default is no file of backup IDs, which means any backup can be verified.
Specifies the name of the client that produced the original backup. The default is any client.
Determines the copy number of the backup ID to verify. Valid values are 1 through the setting that the bpconfig -max_copies setting indicates, up to 10. The default is 1.
-primary indicates that the primary copy should be verified rather than the copy.
Specifies the name of the disk pool, which is the data storage area for this storage unit. Optionally, bpverify verifies the images that reside on the specified disk volume only. This option must be used with the -stype option. The disk pool must already exist.
Specifies the number of hours before the current time to search for backups. This number is equivalent to the specification of a start time (-s) of the current time minus hours. Do not use both this option and the -s option.
The hours value is a non-negative integer. The default starting time is 24 hours ago.
Search the image catalog for backups to verify that they are on this media ID or pathname. If a backup has some fragments on this media ID and some another media ID, the following occurs: NetBackup verifies a spanning image as long as the backup begins on the media of the media ID that is provided.
For the images that are stored on disk rather than removable media, specify an absolute pathname instead of media_id. The default is any media ID or pathname. BasicDisk and NearStore use this option.
Specifies the name of a file in which to write progress information. The default is not to use a progress file, in which case the progress information is written to stderr. For more information, see DISPLAY FORMATS later in this command description.
Include the -en option to generate a log entry in English. The name of the log contains the string _en. This option is useful to the support personnel that assist in a distributed environment where different locales may create logs of various languages.
Specifies that the list type is long, which causes bpverify to write additional information to the progress log. The default list type is short. For additional information, see DISPLAY FORMATS later in this command description.
If you initiate bpverify from a host other than the master server and do not use -local (default), the following occurs: bpverify starts a remote copy of the command on the master server.
The remote copy allows the command to be terminated from the Activity Monitor.
Use -local to prevent the creation of a remote copy on the master server and to run bpverify only from the host where it initiated.
If the -local option is used, bpverify cannot be canceled from the Activity Monitor.
Specifies the master server that provides the bpverify image data. The master server must allow access by the system that issued the bpverify command. The default is the master server for the system where bpverify is entered:
The default is always the master server where the command is entered.
For NetBackup Enterprise Server:
If the command is entered on a master server, then that server is the default.
If the command is entered on a remote media server, then the master for that media server is the default.
Previews the verification, but does not perform the verification. For additional information, see DISPLAY FORMATS later in this command description.
Previews the verification but does not perform the verification. This option is similar to -p, but -pb does not display information about the individual backups. For additional information, see DISPLAY FORMATS later in this command description.
Search for backups to verify in the specified policy. The default is any policy.
Specifies a new priority for the verification job that overrides the default job priority.
Specifies the policy type for selecting backups to verify. The default is any policy type.
The valid policy types are the following:
AFS DataStore DataTools-SQL-BackTrack DB2 Enterprise-Vault FlashBackup Informix-On-BAR Lotus-Notes MS-Exchange-Server MS-SharePoint MS-SQL-Server MS-Windows-NT NBU-Catalog NDMP NetWare Oracle OS/2 SAP Split-Mirror Standard Sybase Teradata
Specifies the start of the range of dates and times that include all backups to verify. The -e option specifies the end of the range.
The required date and
time values format in NetBackup commands varies according to your
locale. The /user/openv/msg/.conf
file (UNIX and Linux) and the install_path\VERITAS\msg\LC.CONF file
(Windows) contain information such as the date-time formats for
each supported locale. The files contain specific instructions on
how to add or modify the list of supported locales and formats.
More information is available about the locale of your system.
See the "Specifying the locale of the NetBackup installation" topic in the NetBackup Administrator's Guide, Volume II.
The valid range of dates is from 01/01/1970 00:00:00 to 01/19/2038 03:14:07. The default start time is 24 hours ago. The default ending time is the current date and time.
Search for backups to verify that the specified schedule created. The default is all schedules.
Search for backups to verify that the specified schedule type created. The default is any schedule type.
INCR (differential-incremental backup)
A string that identifies the storage server type. Possible values are AdvancedDisk, OpenStorage vendorname, PureDisk, and SharedDisk. (SharedDisk applies to NetBackup 6.5 media servers only.)
Selects the verbose mode. When -v is specified, the debug logs and progress logs include more information. The default is not verbose.
bpverify runs a preview by searching for backups and then by displaying them in one of the following ways (bpverify does not verify the backups):
The -p display lists backup IDs that meet the criteria that the bpverify command-line options set. The -p information appears in volume order. For each volume that contains a selected backup, the media ID and server appear. The selected backup IDs that reside on that volume follow them.
The -pb display is a brief version of the -p display. It lists the media ID and server for each volume that contains the backups that meet the selection criteria.
bpverify creates these displays as it verifies images. If bpverify contains no option to set the list format, the display format is short. If the command line contains -l, the display format is long. If the command line contains both -l and -L, bpverify creates a file that contains the progress log.
The following example verifies the backups that ran in the past 36 hours:
# bpverify -hoursago 36 Verify started Thu Feb 3 11:30:29 2003 INF - Verifying policy mkb_policy, schedule Full (plim_0949536546), path /tmp/mkbunit, created 02/02/09 18:09:06. INF - Verify of policy mkb_policy, schedule Full (plim_0949536546) was successful. INF - Status = successfully verified 1 of 1 images.
The following example compares the two preview displays, -p and -pb:
# bpverify -p -hoursago 2002 Media id = A00002 Server = plim Bid = plim_0949616279 Kbytes = 32800 Filenum = 1 Fragment = 1 Bid = gava_0949681647 Kbytes = 12191 Filenum = 2 Fragment = 1 Bid = gava_0949683298 Kbytes = 161 Filenum = 3 Fragment = 1 Bid = gava_0949683671 Kbytes = 11417 Filenum = 4 Fragment = 1 Bid = gava_0949684009 Kbytes = 11611 Filenum = 5 Fragment = 1 Bid = gava_0949684276 Kbytes = 806 Filenum = 6 Fragment = 1 Bid = gava_0949688704 Kbytes = 9869 Filenum = 7 Fragment = 1 Bid = gava_0949688813 Kbytes = 9869 Filenum = 8 Fragment = 1 Bid = gava_0949949336 Kbytes = 10256 Filenum = 9 Fragment = 1 Bid = plim_0949949337 Kbytes = 6080 Filenum = 9 Fragment = 1 Bid = plim_0949949337 Kbytes = 4176 Filenum = 10 Fragment = 2 Bid = gava_0949949686 Kbytes = 10256 Filenum = 11 Fragment = 1 Bid = plim_0949949687 Kbytes = 5440 Filenum = 11 Fragment = 1 Bid = plim_0949949687 Kbytes = 4816 Filenum = 12 Fragment = 2 Media id = 400032 Server = plim Bid = toaster2_0950199621 Kbytes = 298180 Filenum = 1 Fragment = 1 Bid = toaster2_0950199901 Kbytes = 298180 Filenum = 3 Fragment = 1 # bpverify -pb -hoursago 200 Media id = A00002 Server = plim Media id = 400032 Server = plim
An exit status of 0 means that the command ran successfully. Any exit status other than 0 means that an error occurred.
If the administrative log function is enabled, bpverify logs the exit status in the administrative daily log under the log directory:
Windows systems: install_path\NetBackup\logs\admin
bpverify: EXIT status = exit status