bprestore [-A | -B | -rb] [-K] [-l | -H | -y] [-r] [-T] [-L progress_log [-en]] [-R rename_file] [-C client] [-D client] [-S master_server] [-disk_media_server media_server][-t policy_type] [-p policy] [-k "keyword_phrase"] [-cm] [-drs] [-md] [-dd] [-td temp_dir] [-s date] [-e date] [-F file_options] [-spsredir_server hostname] [-spscurver] [-spsignorelock] [-spspreserveiis] [-spsrestoresecurity] [-spsverkeep [0 | 1 | 2]] [-vhd_fn VHD_filename] [-vhd_type 0 | 1] [-vhd_dsize VHD_disk_size] [-vhd_dof 0 | 1] -BR portal_name | teamsite_name | Exchange_2010_redirected_path] [-copy copy_number] [-granular_restore] [-priority number] [-w [hh:mm:ss]] [-ev_migrated_data] -f listfile | filenames [-print_jobid] [-optimized_backup 0 | 1]
On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/
On Windows systems, the directory path to this command is install_path\fR\NetBackup\bin\
bprestore lets users restore a backed up or archived file or list of files. You can also name directories to restore. If you include a directory name, bprestore restores all files and subdirectories of that directory. You can exclude a file or a directory path that was previously included in the restore by placing an exclamation mark (!) in front of the file or the directory path (does not apply to NDMP restores). For example, the exclude capability is useful if you want to exclude part of a directory from the restore.
By default, you are returned to the system prompt after bprestore is successfully submitted. The command works in the background and does not return completion status directly to you. The -w option lets you change this behavior so bprestore works in the foreground and then returns completion status after a specified time period.
The bprestore command restores the file from the most recent backups within the time period you specify, except for a true-image restore. (See the -T option description.)
bprestore overwrites any file of the same name that already exists on the local client disk, unless you include the -K option. You also can restore the files that were backed up or archived on another client (-C option). To restore from other clients, the NetBackup administrator must validate you.
bprestore writes informative and error messages to a progress log file if you do the following: create the file before you run the bprestore command and then specify the file with the -L progress_log option. If bprestore cannot restore the requested files or directories, you can use the progress log to find the reason for the failure.
For detailed troubleshooting information, create a directory that is named /usr/openv/netbackup/logs/bprestore (UNIX systems) or install_path\NetBackup\logs\bprestore (Windows systems) with public-write access. bprestore then creates a debug log file in this directory.
For UNIX systems, if a nonroot user specifies USEMAIL = mail_address in the $HOME/bp.conf file, the following occurs: NetBackup sends mail on the restore completion status to mail_address. This message is sent when the restore process is complete.
The following restrictions apply to bprestore:
DB2 MS-Exchange-Server Informix Lotus-Notes Oracle SAP MS-SQL-Server Sybase TeraData MS-Windows StandardFor all other policy types, the file list must be given in UTF-8 format. The rule applies for the file lists that are given on the command line and file lists that are provided in a file with the -f option.
Use the bplist command to display information on the files and directories that were backed up or archived.
Alternatively, you may specify the copy from which to restore at a global level (for all restore operations). Put the copy number into the file ALT_RESTORE_COPY_NUMBER.
Refer to "Restoring from a specific backup copy" of the NetBackup Backup, Archive, and Restore online Help for a complete description.
On UNIX systems, the master server root user can use this option to do the following: Direct restored files to a computer other than the client that the -C option specifies.
On Windows systems, the master server administrator can use this option to do the following: Direct restored files to a computer other than the client that the -C option specifies.
The following example restores migrated data from Vault1 to master server ms1 using an NDMP policy type. The files to be restored are listed in file restorefiles.
# bprestore -S ms1 -C Vault1 -t 19 -ev_migrated_data restorefiles
The required format for the file list depends on whether the files have spaces or newlines in the names.
To restore the files that do not have spaces or new lines in the names, use this format:
filepathWhere filepath is the path to the file that you restore. For example:
/home /etc /varWindows systems:
C:\programs C:\winnt C:\documents\old_memosTo restore the files that have spaces or new lines in the names, use one of the following formats:
filepathlen filepath filepathlen filepath start_date_time end_date_time filepathlen filepath -s datetime -e datetimeThe filepath is the path to the file you restore.
The filepathlen is the total number of characters in the file path.
The start_date_time and end_date_time are the decimal number of seconds since 01/01/1970 00:00:00.
datetime is the same as the command line (mm/dd/yy [hh[:mm[:ss]]]). The command uses the start date, end date, and time from the command line unless a line in listfile overrides it. The dates may change from line to line.
The required date and time values format in NetBackup commands varies according to your locale. The /usr/openv/msg/.conf file (UNIX) 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.
See "About specifying the locale of the NetBackup installation" in the NetBackup Administrator's Guide, Volume II.
To exclude a file or a directory path that was previously included in the restore, place an exclamation mark (!) in front of the file or the directory path. NDMP and FlashBackup restores do not support the exclude option.
The following is an example that uses filepathlen filepath:
UNIX systems:
5 /home 4 /etc 4 /var 19 /home/abc/test file 12 !/etc/passwdWindows systems:
11 C:\programs 8 C:\winnt 22 C:\documents\old memos 17 !C:\programs\test -f filenamesNames one or more files to be restored and can be used instead of the -f option.
Any files that you specify must be listed at the end of the command line after all other options. You must use absolute file paths.
To exclude a file or a directory path that was previously included in the restore, place an exclamation mark (!) in front of the file or the directory path. NDMP and FlashBackup restores do not support the exclude option.
For Windows systems, use upper case for the drive letter. For example, C:\NetBackup\log1.
When you use -K with the rollback (-rb) option, it means to not perform verification before the rollback. Files that are added on the volume after the snapshot is taken would be lost.
Use this option in place of or in combination with the other restore options to more easily restore your backups and archives. The meta-characters that follow simplify the match of keywords or parts of keywords in the phrase:
* matches any string of characters.
The "?" character matches any single character.
[ ] matches one of the sequence of characters that is specified within the brackets.
[ - ] matches one of the range of characters that the "-" separates.
The keyword phrase can be up to 128 characters in length. All printable characters are permitted including space (" ") and period (".").
The phrase must be enclosed in double quotes ("...") or single quotes (oq...cq).
The default keyword phrase is the null (empty) string.
UNIX systems: netbackup/logs/user_ops/proglog
Windows systems: NetBackup\logs\user_ops\proglog
The default is not to use a progress log.
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 support any personnel that assist in a distributed environment where different locales may create logs of various languages.
Only default paths are allowed for this option and Veritas recommends to use the default paths. If you cannot use the NetBackup default path in your setup, you should add custom paths to the NetBackup configuration.
For more information on how to add a custom path, see the lqBPCD_WHITELIST_PATH option for NetBackup servers and clientsrq topic in the NetBackup Administrator's Guide, Volume I.
Specify -H to rename UNIX hard links by using the -R rename_file option in the same way as when you rename files. Soft links are unchanged.
Specify -y to rename UNIX soft links by using the -R rename_file option in the same way as when you rename files. Hard links are unchanged.
See Example 5 in the EXAMPLES section.
For example: bprestore -R /C/renamefile /C/origfile
Where /C/rename_file is the file with the name change and /C/origfile is the file to be renamed. The pathname that you enter must be an absolute path.
Use the following form for entries in the rename file:
change backup_filepath to restore_filepathThe file paths must start with / (slash)
The first backup_filepath that is matched is replaced with the restore_filepath string.
The default is to restore by using the original path.
On UNIX systems: For example, the following entry renames /usr/fred to /usr/fred2:
change /usr/fred to /usr/fred2On Windows systems: For example, the following entry renames C:\users\fred to C:\users\fred2:
change /C/users/fred to /C/users/fred2Use all upper case for the drive letter and end the entry with a return.
When you restore to a Windows client, you can also use the following method for specifying entries in the rename file. (Do not use this method for other clients.)
rename bulength backup_filepath reslength restore_filepathWhere:
bulength is the number of ASCII characters in the backup path.
reslength is the number of ASCII characters in the restore path.
The first backup_filepath that is matched is replaced with the restore_filepath string.
For example, the following entry renames C:\fred.txt to C:\fred2.txt:
rename 11 /C/fred.txt 12 /C/fred2.txt(Be sure to end the entry with a return.)
Only default paths are allowed for this option and Veritas recommends to use the default paths. If you cannot use the NetBackup default path in your setup, you should add custom paths to the NetBackup configuration.
For more information on how to add a custom path, see the lqBPCD_WHITELIST_PATH option for NetBackup servers and clientsrq topic in the NetBackup Administrator's Guide, Volume I.
-s specifies a start date and time for the restore window. bprestore restores files only from the backups or the archives that occurred at or after the specified date and time.
More information is available about the locale of your system.
See "About specifying the locale of the NetBackup installation" 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 date is 01/01/1970 00:00:00.
The default is to return the most recent image. For backups, this image is the most recent full backup if a full backup exists. If a full backup does not exist, then the most recent incremental or user-directed backup is restored.
-e specifies an end date and time for the restore window. bprestore restores only files in the backups or the archives that occurred at or before the specified date and time. Use the same format as for the start date and time.
The end backup date and time do not need to be exact, except for a true-image restore (see the -T option description). bprestore restores the file that has the specified backup date and time. Or it restores the file that precedes the end date and time, which is the most recent backup. The default is the current date and time.
On UNIX systems, the default is the first server found in the /usr/openv/netbackup/bp.conf file.
On Windows systems, the default is the server designated as current on the Servers tab of the Specify NetBackup Machines dialog box. To display this dialog box, start the Backup, Archive, and Restore user interface on the client. Then click Specify NetBackup Machines on the File menu.
0 = Standard
8 = MS-SharePoint
13 = MS-Windows
16 = MS-Exchange-Server
19 = NDMP
20 = FlashBackup
21 = Split-Mirror
25 = Lotus-Notes
29 = FlashBackup-Windows
30 = Vault
35 = NBU-Catalog
38 = PureDisk-Export
39 = Enterprise-Vault
40 = VMware
41 = Hyper-V
44 = BigData
When the -T option is specified, the image that is requested must be uniquely identified. Unique identification is accomplished by using the -e option with seconds granularity. The -s option (if any) is ignored. The seconds granularity of an image can be retrieved by using the bplist command with the -l and -Listseconds options.
On UNIX systems, the default location is /temp.
On Windows systems, the default location is C:\temp.
1 - Fixed.
2 - Dynamic.
The required date and time values format in NetBackup commands varies according to your locale. The /usr/openv/msg/.conf file (UNIX) 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 "About specifying the locale of the NetBackup installation" in the NetBackup Administrator's Guide, Volume II.
You can optionally specify a wait time in hours, minutes, and seconds. The maximum wait time you can specify is 23:59:59. If the wait time expires before the restore is complete, the command exits with a timeout status. The restore, however, still completes on the server.
If you specify 0 or do not specify a time, the wait time is indefinite for the completion status.
Example 1 - Restore files from backups of file1 that were performed between 04/01/2010 06:00:00 and 04/10/2010 18:00:00. Enter the following:
UNIX systems:
# bprestore -s 04/01/2010 06:00:00 -e 04/10/2010 18:00:00 /usr/user1/file1
Windows systems:
# bprestore -s 04/01/2010 06:00:00 -e 04/10/2010 18:00:00 C:\user1\file1
Example 2 - Restore the files that are listed in a file named restore_list by using the most recent backups, enter the following:
UNIX systems:
# bprestore -f restore_list
Windows systems:
# bprestore -f c:\restore_list
Example 3
UNIX systems:
Restore directory /home/kwc from the backups that are associated with a keyword phrase that contains "My Home Directory". Use a progress log named /usr/openv/netbackup/logs/user_op/bkup.log. Enter the following on one line:
# bprestore -k "*My Home Directory*" -L /usr/openv/netbackup/logs/user_op/bkup.log /home/kwc
Windows systems:
Restore directory C:\kwc from the backups that are associated with a keyword phrase that contains "My Home Directory". Use a progress log named c:\Program Files\Veritas\NetBackup\logs\user_ops\bkup.log. Enter the following on one line:
# bprestore -k "*My Home Directory*" -L c:\Program Files\Veritas\NetBackup\logs\user_ops\bkup.log C:\kwc
Example 4 - Restore the D drive on the Windows client slater from the backups that are associated with a keyword phrase that contains "My Home Dir". Use a progress log named bkup.log. Enter the following all on one line or use the backslash continuation character:
UNIX systems:
# bprestore -k "*My Home Dir*" -C slater -D slater -t 13 -L /usr/openv/netbackup/logs/user_op/bkup.log /D
Windows systems:
# bprestore -k "*My Home Dir*" -C slater -D slater -t 13 -L c:\Program Files\Veritas\NetBackup\logs\user_ops\bkup.log D:\
Example 5 - Assume that you have a rename file named /usr/openv/netbackup/logs/user_ops/rename on a UNIX client and it contains the following:
change /home/kwc/linkback to /home/kwc/linkback_alt
To restore the hard link that is named /home/kwc/linkback to alternate path /home/kwc/linkback_alt on that client, run the following command:
# bprestore -H -R /usr/openv/netbackup/logs/user_ops/rename /home/kwc/linkback
Example 6 - Assume that you want to restore files from backups of the file user1.
The backups were performed between 04/01/12 06:00:00 and 04/10/12 18:00:00. You also want to exclude all files with a .pdf extension, except for the file named final_doc.pdf. To perform this operation, run the following (on one line):
UNIX systems:
# bprestore -s 04/01/12 06:00:00 -e 04/10/12 \ 18:00:00 /home/user1 !/home/user1/*.pdf /home/user1/final_doc.pdf
Windows systems:
# bprestore -s 04/01/12 06:00:00 -e 04/10/12 18:00:00 C:\user1\ !C:\user1\*.pdf C:\user1\final_doc.pdf
UNIX systems:
$HOME/bp.conf /usr/openv/netbackup/logs/bprestore/log.mmddyy
Windows systems:
install_path\NetBackup\logs\bprestore\*.log
bp, bparchive, bplist