Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
bpduplicate — 创建由 NetBackup 创建的备份的副本
大纲
-npc new_primary_copy -backupid backup_id [-local] [-client name]
[-number_copies number] [-dstunit destination_storage_unit_label[,copy2,...]] [-dp destination_volume_pool_name[,copy2,...] [-p | -pb | -PD | -PM] [-Bidfile file_name] [-v] [-local] [-client name] [-st sched_type] [-sl sched_label] [-L output_file [-en]] [-shost source_host] [-policy name] [-s date] [-e date] [-pt policy_type] [-hoursago hours] [[-cn copy_number] | [-primary]] [-dcn copy_number_1[copy_number_2,...,copy_number_n]] [-M master_server] [-altreadhost hostname] [-backupid backup_id] [-id media_id] [-rl retention_level[,rl-copy2,...]] [-fail_on_error 0|1[,...,0|1]] [-mpx] [-priority number] [-set_primary copy_index] [-bc_only] [-granular_proxy hostname] [-owner media_share_group[,copy2,...]]
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
bpduplicate 命令可以创建备份副本。bpduplicate 命令还可以更改主副本,以便能从复制的备份进行还原。主副本用于满足还原请求,它最初为原始副本。
可以使用 -mpx 选项来创建多路复用复制。有关更多信息,请参考关于 -mpx 选项的论述。
复制的备份的截止日期与它的原始副本无关。开始时,将该副本的截止日期设置为与其原始副本一样。之后,可以使用 bpexpdate 命令更改该副本或原始副本的截止日期。
使用 bpduplicate 最多可为尚未失效的备份创建 10 个副本。
选项
- -altreadhost hostname
指定将从中读取介质的备用主机。默认情况下,bpduplicate 从执行此次备份操作的主机读取源介质。
- -backupid backup_id
指定要复制的单个备份的备份 ID,或者指定要更改其主副本的单个备份的备份 ID。
- -bc_only
编录粒度信息(即仅建立目录库)。运行此选项后无需再生成映像副本,这样可以改进以后的浏览或还原操作的性能。
- -Bidfile file_name
file_name 用于指定一个文件,该文件包含要复制的备份 ID 的列表。在该文件中,每行列出一个备份 ID。如果指定该参数,则忽略其他的选择条件。
此外,由于 NetBackup GUI 经常使用此参数,因此在执行该命令行界面 (CLI) 的过程中将会删除 file_name。这些 GUI 要求命令行界面在执行完成后删除用于 -Bidfile 选项的临时文件。命令行界面的直接用户也可使用此选项,但此选项将删除该文件。
- -client name
指定以下客户端的名称:该客户端生成原始副本,本身还用作搜索条件来查找要复制的备份。默认值为所有客户端。
如果指定 -client 以及 -npc 选项来更改主副本,NetBackup 会首先搜索属于客户端的备份 ID。在已更改客户端名称的情况下,此搜索非常有用。
- -cn copy_number|-primary
确定要复制的副本号。有效值介于 1 到 10 之间。默认值为 1。
-primary 表示搜索或复制主副本。
- -dcn copy_number_1[copy_number_2,...,copy_number_n]
目标副本号选项指定使用 bpduplicate 命令生成的新副本的副本号。此选项接受以逗号分隔的多个编号。如果指定了多个副本号,您必须使用 –number_copies。–number_copies 选项必须与指定的副本数匹配。例如,如果指定了 -dcn 3,4,则必须指定 –number_copies 2。如果指定了 -dcn 3,则可以指定 –number_copipes 1 或将其省略。
请注意,多个副本无法使用相同的副本号。如果指定的副本号已存在,命令将失败。如果省略此选项,bpduplicate 命令将分配下一个可用副本号。
- -dp destination_volume_pool_name [,copy2,...]
指定用于复制的卷池。NetBackup 不会验证为复制副本选定的介质 ID 与原始副本所在的介质 ID 是否不同。因此,为了避免发生死锁,请指定一个与原始介质 ID 所在位置不同的卷池。默认的池名称是 NB_duplicates。
为每个指定的副本指定一个池。
- -dstunit destination_storage_unit_label [,copy2,...]
指定目标存储单元。在复制备份时,必须使用此参数。要预览将复制的备份(-p、-pb、-PM 或 -PD 选项)或者更改主副本(-npc 选项),请不要指定该选项。此选项没有默认值。
为每个指定的副本指定存储单元。
- -e date, -s date
指定包括了所有要复制的备份的日期和时间范围的终点 (-e) 或起点 (-s)。默认结束日期是当前的日期和时间。默认开始时间是当前日期和时间的 24 小时之前。
NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。
/usr/openv/msg/.conf
文件 (UNIX) 和install_path\VERITAS\msg\LC.CONF
文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。有关系统区域设置的更多信息,请参见 NetBackup 管理指南,第 II 卷中的“关于指定 NetBackup 安装的区域设置”。
- -fail_on_error 0|1[,0|1,...,0|1]
指定当副本失败时是否停用其他副本,其中:
0 - 不停用其他副本
1 - 停用其他副本
可为每个指定的副本分别指定一个选择。
- -granular_proxy
针对复制操作覆盖已定义的 Exchange 粒度还原代理主机。如果是复制到磁带,此主机将编录粒度信息。默认情况下,所定义的 Exchange 粒度还原代理主机是该备份的原始 Exchange 客户端。可以在备份客户端的客户端主机 Exchange 属性中配置代理主机。
- -hoursago hours
从当前时间算起,指定要搜索此前多少小时之内的备份。不要与 -s 选项一起使用。默认值是前一天午夜 12 点。
- -id media_id
搜索该介质 ID 上要复制的备份的映像目录库。如果原始备份分散在不同的介质 ID 上,则 NetBackup 仅复制位于指定介质 ID 上的备份。虽然可复制跨介质的备份,但对于位于不同介质 ID 上的任何其他备份,不要执行这一操作。
- -L output_file [-en]
指定要在其中写入进度信息的文件的名称。默认为不使用进度文件。
UNIX 系统示例:
/usr/openv/netbackup/logs/user_ops
Windows 系统示例:
c:\Program Files\Veritas\NetBackup\logs\user_ops
使用 -en 选项可生成英文日志。日志名称中包含字符串 _en。在分布式环境中,不同的语言环境可能创建不同语言的日志,此时该选项对于支持人员很有用。
仅允许对此选项使用默认路径,建议使用默认路径。如果无法在您的设置中使用 NetBackup 默认路径,应向 NetBackup 配置中添加自定义路径。
有关如何添加自定义路径的更多信息,请参见 NetBackup 管理指南,第 I 卷中的“NetBackup 服务器和客户端的 BPCD_WHITELIST_PATH 选项”主题。
- -local
如果从主服务器以外的主机运行 bpduplicate 且未使用 -local(默认值),则发生以下情况:它将在主服务器上启动该命令的远程副本。该远程副本允许从活动监视器终止该命令。
使用此选项可阻止在主服务器上创建远程副本。只能从启动 bpduplicate 的主机上运行它。
如果使用了 -local 选项,将无法从活动监视器中取消 bpduplicate。
- -M master_server
指定用于管理具有该介质 ID 的介质目录库的主服务器。如果未指定该选项,则默认值为以下服务器之一:
NetBackup 服务器仅支持一台没有远程介质服务器的服务器(主服务器)。因此,在这种情况下,默认值始终为运行此命令的 NetBackup 服务器主服务器。
在 NetBackup Enterprise Server 中,如果在主服务器上运行该命令,则该服务器为默认服务器。如果在不是主服务器的介质服务器上运行该命令,则该介质服务器的主服务器为默认服务器。
- -mpx
指定当复制多路复用备份时,NetBackup 在目标介质上创建多路复用备份,这样可减少复制多路复用备份的时间。
以下操作不支持多路复用复制:
非多路复用备份
从磁盘类型存储单元进行的备份
向磁盘类型存储单元执行的备份
FlashBackup 或 NDMP 备份
如果复制期间遇到了以上类别的备份,NetBackup 将首先使用非多路复用复制方法对其进行复制。然后,使用多路复用复制的方法复制多路复用备份。
如果未复制多路复用组中的所有备份,复制后的多路复用组将具有不同的片段布局)
如果未指定该选项,则使用非多路复用复制的方法来复制所有备份。
有关多路复用操作的更多信息,请参见 NetBackup 管理指南,第 I 卷。
- -npc new_primary_copy
允许更改主副本。该值可以是 1 到 10 之间的数字。指定该选项时,必须同时指定 -backupid。
- -number_copies number
指定要创建的副本数。如果没有安装“内联磁带复制”选件或 NetBackup Vault 扩展,只能将此值设置为 1。默认值为 1。
与 -dstunit、-dp、-fail_on_error 以及 -r1 一起使用:
-number_copies 2 -dstunit stunit-copy1,stunit-copy2 -number_copies 2 -dp pool1, pool2
- -owner media_share_group [,share_group_copy2,...]
为复制指定共享组。为指定的每个副本指定一个共享组。
- -p
根据选项设置来预览要复制的备份,但并不执行复制操作。显示介质 ID、服务器名称、不能用于复制的备份(及不能复制的原因),以及有关要复制的备份的信息。
- -pb
预览复制,但并不执行复制操作。该选项类似于 -p 选项,区别是不显示有关备份的信息。
- -PD
该选项与 -PM 选项相同,只不过它按日期和时间对备份进行排序并显示备份(从最新到最旧)。
- -PM
根据选项设置来显示有关要复制的备份的信息,但并不执行复制操作。该格式首先显示无法复制的备份 ID 及原因(例如,备份已经有两个副本)。它显示有关备份的以下信息:备份的日期和时间、策略、日程表、备份 ID、主机、介质 ID 或路径、副本号,以及副本是否为主副本:
1 = 主副本
0 = 非主副本
- -policy name
在指定策略中搜索要复制的备份。默认值为所有策略。
- -priority number
将备份策略的优先级设置为比磁盘分段作业复制高或低。
- -pt policy_type
搜索由指定的策略类型创建的备份。默认值为任意策略类型。
policy_type 为以下字符串之一:
Auspex-FastBackup BigData DataStore DataTools-SQL-BackTrack DB2 Enterprise-Vault FlashBackup FlashBackup-Windows Hyper-V Informix-On-BAR LotusNotes MS-Exchange-Server MS-SharePoint MS-SQL-Server MS-Windows NDMP Oracle PureDisk-Export SAP Split-Mirror Standard Sybase Vault VMware
- -rl retention_level[,rl-copy2,...]
为每个指定的副本提供一个保留级别。
如果未指定保留级别,每个副本将使用其原始副本的截止日期。如果指明了保留期限,则副本的截止日期为备份日期加上保留期限。
例如,如果备份是在 2012 年 5 月 14 日创建的,它的保留期限为 1 周,则新副本的截止日期为 2012 年 5 月 21 日。
如果值为 -1,则表明该副本使用原始副本的截止日期。
- -set_primary copy_index
指定将成为主副本的新副本。
copy_index 为以下值之一:
0 = 不更改主副本(默认值)
1 = 第一个新副本将成为主副本
2 = 第二个新副本将成为主副本
3 = 第三个新副本将成为主副本,依此类推。
copy_index 不能大于 -number_copies 值。
如果指定为主副本的副本已损坏,但其他副本没有问题,则不会更改主副本的当前值。
- -shost source_host
指定仅考虑对指定的备份服务器上创建的备份进行复制。默认值为无论使用哪个备份服务器,都考虑复制所有备份。
- -sl sched_label
搜索由指定的日程表创建并且要进行复制的备份。默认值为所有日程表。
- -st sched_type
搜索由指定的日程表类型创建并且要进行复制的备份。默认值为任意日程表类型。
有效值包括:
FULL(完全备份)
INCR(差异增量式备份)
CINC(累积增量式备份)
UBAK(用户备份)
UARC(用户存档)
NOT_ARCHIVE(除用户存档之外的所有备份)
- -v
选择详细模式。指定调试日志或进度日志时,该选项将生成更多信息。
示例
示例 1 - 列出副本号为 1 的备份。它们由名为 stdpol
的策略备份,而且在 2013 年 7 月 1 日和 2013 年 8 月 1 日之间创建。
# bpduplicate -PM -cn 1 -policy stdpol -s 07/01/13 -e 08/01/13
示例 2 - 复制 tmp 目录下 bidfile 文件中所列出备份的副本 1。目标存储单元为 unit1,目标池为 dup_pool。进度信息将写入 bpdup.ls 中。下列命令可以全部位于一行上,也可以使用反斜杠续行符分成多行。
UNIX 系统:
# bpduplicate -dstunit unit1 -Bidfile /tmp/bidfile -L /usr/openv/netbackup/logs/user_ops/bpdup.ls -dp dup_pool -cn 1
Windows 系统:
# bpduplicate -dstunit unit1 -Bidfile C:\tmp\bidfile -L c:\Program Files\Veritas\NetBackup\logs\user_ops\bpdup.ls -dp dup_pool -cn 1
示例 3 - 此示例与示例 2 相同,但当您选择多路复用复制时会复制多路复用备份。下列命令可以全部位于一行上,也可以使用反斜杠续行符分成多行。
UNIX 系统:
# bpduplicate -dstunit unit1 -Bidfile /tmp/bidfile -mpx -L /usr/openv/netbackup/logs/user_ops/bpdup.ls -dp dup_pool -cn 1
Windows 系统:
# bpduplicate -dstunit unit1 -Bidfile C:\tmp\bidfile -mpx -L c:\Program Files\Veritas\NetBackup\logs\user_ops\bpdup.ls -dp dup_pool -cn 1
文件
UNIX 系统:
/usr/openv/netbackup/logs/admin/* /usr/openv/netbackup/db/images/*
Windows 系统:
install_path\NetBackup\db\images\* install_path\NetBackup\logs\admin\*
另请参见
请参见nbreplicate(1m)。