bprestore

bprestore – 从 NetBackup 服务器还原文件
大纲
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]

在 UNIX 系统上，此命令的目录路径为 /usr/openv/netbackup/bin/
在 Windows 系统中，此命令的目录路径为 install_path\NetBackup\bin\

描述

用户可通过 bprestore 还原一个或多个已备份或已存档的文件。您也可以命名要还
原的目录。如果包括一个目录名，bprestore 将还原此目录中的所有文件和子目
录。可以使用以下方法排除在以前的还原操作中包括的文件或目录路径：在文件或
目录路径的前面放置一个惊叹号 (!)（不适用于 NDMP 还原）。例如，如果您希望
在还原时排除目录的某一部分，这种排除功能将非常有用。

注意：如果未指定策略或日期范围，bprestore 将从最近的完全备份映像开始。包
括所有后续的增量式和差异备份映像。将从这些映像中还原文件的最新副本。
默认情况下，成功提交 bprestore 后，将返回到系统提示符状态。该命令在后台工
作，它并不直接返回完成状态。可以通过使用 -w 选项来更改此行为，使 bprestore
在前台工作，并在指定的时间段之后返回完成状态。
bprestore 命令使用指定时间段内的最新备份来还原文件，但实际映像还原除外。
（请参见 -T 选项的说明。）

bprestore除非包括 -K 选项，否则 bprestore 会重写本地客户端磁盘上已存在的任何同名文
件。您还可以还原在另一个客户端（-C 选项）上备份或存档的文件。要从其他客户
端还原，必须先接受 NetBackup 管理员的验证。

常用选项

-A | -B | -rb
指定数据将从存档 (-A)、备份 (-B) 还是快照回滚 (-rb) 还原。默认值为 -B。
注意：回滚 (-rb) 操作始终从副本 1 进行。如果副本 1 过期，则回滚失败。

bprestore-C client
指定客户端名称，以查找用于从中还原文件的备份或存档。该名称必须与它在
NetBackup 目录库中显示的名称相同。其默认值是当前客户端的名称。
注意：默认情况下，目标客户端并不是源客户端。请参见 -D client 选项的说明。

-copy copy_number
指定要用于还原的副本号。用户可以从主副本以外的其他副本进行还原。例
如，-copy 3 将还原文件或文件列表的副本 3。
另外，可以在全局级别（适用于所有还原操作）指定要从其还原的副本。将副
本编号放置在文件 ALT_RESTORE_COPY_NUMBER 中。

-D client
指定目标客户端。其默认值是当前客户端的名称。
在 UNIX 系统上，主服务器 root 用户可以使用此选项执行以下操作：将已还原
的文件定向至 -C 选项指定的客户端之外的其他计算机。
在 Windows 系统上，主服务器管理员可以使用此选项执行以下操作：将已还
原的文件定向至 -C 选项指定的客户端之外的其他计算机。

-f listfile
指定一个文件 (listfile)，其中包含要还原的文件列表，且可以不用 filenames 选
项来使用该文件。在 listfile 中列出所有文件路径，每个路径必须单独占一行。
文件列表所要求的格式取决于文件名称中是否包含空格或换行符。
要还原名称中不包含空格或换行符的文件，请使用以下格式：
filepath
其中，filepath 是要还原的文件的路径。例如：
注意：对于 Windows 系统，驱动器盘符使用大写字母。例如，C:\NetBackup\Log1。
UNIX 系统：
/home
Windows 系统：
C:\programs
要还原名称中包含空格或换行符的文件，请使用以下格式之一：
filepathlen filepath
filepathlen filepath start_date_time end_date_time
filepathlen filepath -s datetime -e datetime
filepath 是要还原的文件的路径。
filepathlen 是文件路径中的总字符数。
要排除在以前的还原操作中包括的文件或目录路径，请在该文件或目录路径前
面放置一个惊叹号 (!)。NDMP 和 FlashBackup 还原不支持排除选项。
以下是 filepathlen filepath 的一个使用示例：
UNIX 系统：
5 /home
4 /etc
4 /var
19 /home/abc/test file
12 !/etc/passwd
Windows 系统：
11 C:\programs
8 C:\winnt
22 C:\documents\old memos
17 !C:\programs\test

-f filenames
命名一个或多个要还原的文件，可用来代替 -f 选项。
必须将指定的任何文件列在命令行结尾处，位于所有其他选项之后。必须使用绝对文件路径。
要排除在以前的还原操作中包括的文件或目录路径，请在该文件或目录路径前
面放置一个惊叹号 (!)。NDMP 和 FlashBackup 还原不支持排除选项。
对于 Windows 系统，驱动器盘符使用大写字母。例如，C:\NetBackup\log1。

-F file_options
允许恢复 NetBackup 文件。

-granular_restore
启用 Active Directory 中对象和属性的还原。如果未指定此选项，还原仍会运
行，但备份无法生成粒度还原。

-k "keyword_phrase"
指定 NetBackup 在搜索用来还原文件的备份或存档时使用的关键字短语。该短
语必须与此前和备份或存档相关联的关键字短语匹配，该备份或存档是使用
bpbackup 或 bparchive 命令的 -k 选项创建的。
请使用该选项代替其他还原选项，或者将该选项与其他还原选项结合使用，以
便更加轻松地还原备份和存档。以下元字符用于简化与短语中的关键字或部分
关键字匹配的任务：

• 匹配任何字符串。
  ？ 字符匹配任何单个字符。
  [ ] 匹配中括号内指定的字符序列中的一个字符。
  [ - ] 匹配由 - 分隔的字符范围中的一个字符。
  关键字短语的长度最多可达 128 个字符。允许使用所有可打印字符，包括空格
  ( ) 和句号 (.)。
  短语必须用双引号 ("...") 或单引号 ('...') 括起来。
  默认的关键字短语为空字符串。

-L progress_log [-en]
指定要在其中写入进度信息的现有文件的名称。例如：
UNIX 系统：netbackup/logs/user_ops/proglog
Windows 系统：NetBackup\logs\user_ops\proglog
默认情况下，不使用进度日志。
使用 -en 选项可生成英文的日志条目。

-M
启用要监视的客户端作业。

-p policy
指定为其执行了备份或存档的策略。

-print_jobid
向 stdout 显示 bprestore 命令所启动的还原作业的作业 ID。

-r
指定此选项将还原原始分区（UNIX 系统）或磁盘映像（Windows 系统），而
不是文件系统。

-R rename_file
为备用路径还原操作指定更改后的文件名。
例如：bprestore -R /C/renamefile /C/origfile
其中 /C/rename_file 是更改名称后的文件，/C/origfile 是要重命名的文件。
输入的路径名必须为绝对路径。
重命名文件中的条目使用以下形式：
change backup_filepath to restore_filepath
文件路径必须以 /（斜杠）开头。
在 UNIX 系统上：例如，下面的条目将 /usr/fred 重命名为 /usr/fred2：
change /usr/fred to /usr/fred2
在 Windows 系统上：例如，下面的条目将 C:\users\fred 重命名为
C:\users\fred2：
change /C/users/fred to /C/users/fred2
驱动器盘符全部使用大写字母，并用回车键结束该条目。
还原到 Windows 客户端时，还可以使用以下方法来指定重命名文件中的条目。
（请勿将此方法用于其他客户端。）
rename bulength backup_filepath reslength
restore_filepath
其中：
bulength 是备份路径中 ASCII 字符的数量。
reslength 是还原路径中 ASCII 字符的数量。
第一个匹配的 backup_filepath 将替换为 restore_filepath 字符串。
例如，下面的条目将 C:\fred.txt 重命名为 C:\fred2.txt：
rename 11 /C/fred.txt 12 /C/fred2.txt（一定要用回车键结束该条目。）
仅允许对此选项使用默认路径。Veritas 建议使用默认路径。如果无法在您的设
置中使用 NetBackup 默认路径，应向 NetBackup 配置中添加自定义路径。

-s date, -e date
指定列表的开始和结束日期范围。bprestore 命令仅从在指定的开始和结束日
期范围内创建的备份或存档还原文件。

-s 为还原时段指定开始日期和时间。bprestore 仅从在指定的日期和时间之后
（包括此时间）创建的备份或存档还原文件。
注意：要还原多数据流映像，请先运行 bplist -l 获取在上次包含文件的备份
过程中所需文件的修改时间。在运行 bprestore 命令时，请将该日期指定为-s。
如果没有为已使用多数据流备份的文件指定开始日期或结束日期，可能会生成错误。
默认情况下返回最新的映像。对于备份，此映像为最新的完全备份（如果存在
完全备份）。如果不存在完全备份，则还原最新的增量式备份或用户控制的备份。

-e 为还原时段指定结束日期和时间。bprestore 仅从在指定的日期和时间（或
之前）创建的备份或存档还原文件。所用的格式与开始日期和时间的格式相同。
除非针对实际映像还原，否则结束备份的日期和时间不必十分精确（请参见 -T
选项的说明）。bprestore 将还原具有指定备份日期和时间的文件。如果没有
指定，它将还原结束日期和时间之前的文件（最新备份）。默认值是当前的日
期和时间。

-S master_server
指定 NetBackup 服务器的名称。
在 UNIX 系统上，默认为 /usr/openv/netbackup/bp.conf 文件中的第一个服
务器。
在 Windows 系统上，默认为在“指定 NetBackup 计算机”对话框的“服务
器”选项卡上被指定为当前服务器的服务器。若要显示此对话框，请在客户端
上启动“备份、存档和还原”用户界面。然后在“文件”菜单上单击“指定NetBackup 计算机”。

-t policy_type
指定与策略类型相对应的以下编号之一。Windows 客户端的默认编号是 13，
所有其他客户端的默认编号都是 0。
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

-T 指定实际映像还原，即仅还原在上次实际映像备份中存在的文件和目录。该选
项仅在执行了实际映像备份后才有用。如果未指定该选项，则还原所有符合指
定条件的文件和目录，即使它们已被删除也是如此。
bprestore如果指定了 -T 选项，则所请求的映像必须具有唯一标识。可以使用具有秒粒
度的 -e 选项来实现唯一标识。此时将忽略 -s 选项（如果有）。可以使用带-l 和 -Listseconds 选项的 bplist 命令来检索映像的秒粒度。

bprestore示例

示例 1 - 要从在 2010 年 4 月 1 日 06:00:00 至 2010 年 4 月 10 日 18:00:00 期间执
行的 file1 备份还原文件，请输入以下命令：
UNIX 系统：
#bprestore -s 04/01/2010 06:00:00 -e 04/10/2010 18:00:00
/usr/user1/file1
Windows 系统：
#bprestore -s 04/01/2010 06:00:00 -e 04/10/2010 18:00:00
C:\user1\file1

示例 2 - 要使用最新备份来还原 restore_list 文件中列出的文件，请输入以下命
令：
UNIX 系统：
#bprestore -f restore_list
Windows 系统：
#bprestore -f c:\restore_list

示例 3
UNIX 系统：
从与包含 My Home Directory 的关键字短语相关联的备份还原目录 /home/kwc。使
用名为 /usr/openv/netbackup/logs/user_op/bkup.log 的进度日志。在一行内
输入如下内容：
#bprestore -k "My Home Directory"
-L /usr/openv/netbackup/logs/user_op/bkup.log
/home/kwc
Windows 系统：
从与包含 My Home Directory 的关键字短语相关联的备份还原目录 C:\kwc。使用
名为 c:\Program Files\Veritas\NetBackup\logs\user_ops\bkup.log 的进度
日志。在一行内输入如下内容：
#bprestore -k "My Home Directory"
-L c:\Program Files\Veritas\NetBackup\logs\user_ops\bkup.log
C:\kwc

bprestore示例 4 - 从与包含 My Home Dir 的关键字短语相关联的备份还原 Windows 客户端
slater 上的驱动器 D。使用名为 bkup.log 的进度日志。在一行内输入以下全部命令
或使用反斜杠续行符：
UNIX 系统：
#bprestore -k "My Home Dir" -C slater -D slater -t 13 -L /usr/openv/netbackup/logs/user_op/bkup.log /D
Windows 系统：
#bprestore -k "My Home Dir" -C slater -D slater -t 13
-L c:\Program Files\Veritas\NetBackup\logs\user_ops\bkup.log D:\

示例 5 - 假定 UNIX 客户端上有一个名为
/usr/openv/netbackup/logs/user_ops/rename 的重命名文件，并且它包含以下命令：
change /home/kwc/linkback to /home/kwc/linkback_alt
要将名为 /home/kwc/linkback 的硬链接还原到该客户端中的备用路径
/home/kwc/linkback_alt，请运行以下命令：
#bprestore -H -R
/usr/openv/netbackup/logs/user_ops/rename
/home/kwc/linkback

示例 6 - 假定您要从文件 user1 的备份还原文件。
备份是在 2012 年 4 月 1 日 06:00:00 至 2012 年 4 月 10 日 18:00:00 期间执行的。
此外，您还想排除扩展名为 .pdf 的所有文件，但 final_doc.pdf 文件除外。要执
行此操作，请在一行内运行以下命令：
UNIX 系统：
#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 系统：
#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 系统：
bprestore$HOME/bp.conf
/usr/openv/netbackup/logs/bprestore/log.mmddyy
Windows 系统：
install_path\NetBackup\logs\bprestore*.log