Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
bpimport — 导入已失效或来自另一 NetBackup 服务器的 NetBackup 备份
大纲
-create_db_info -id media_id or path | -stype server_type [-dp disk_pool_name [-dv disk_volume]] [-server name] [-L output_file [-en]] [-local] [-nh ndmp_host [-mst media_subtype]]
-drfile -id media_id or path | -stype server_type [-dp disk_pool_name [-dv disk_volume]] -drfile_dest dir_name_on_master [-client name] [-server name] [-L output_file [-en]] [-priority number]
[-l] [-p] [-pb] [-PD] [-PM] [-v] [-local] [-client name] [-M master_server] [-Bidfile file_name] [-st sched_type] [-sl sched_label] [-L output_file [-en]] [-policy name] [-s startdate] [-e enddate] [-pt policy_type] [-hoursago hours] [-cn copy_number] [-backupid backup_id] [[-id media_id | path] | -stype server_type]] [-dp disk_pool_name [-dv disk_volume]] [-priority number] [-from_replica]
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
bpimport 命令用于导入备份。在导入已失效或来自另一 NetBackup 服务器的备份时,该命令非常有用。
导入操作由以下两个阶段组成:
阶段 1 是用“提要”中所出现的第一种形式的命令(-create_db_info 选项)执行的。使用此步骤可以为指定介质上的备份重新创建目录库条目。
阶段 2 是用“提要”中所出现的第二种形式的命令执行的。使用此步骤可以从介质中导入备份。
已导入的备份的截止日期是当前日期加上保留期限。例如,如果在 2012 年 11 月 14 日导入某个备份,其保留级别为一周,则它的新截止日期是 2012 年 11 月 21 日。
如果导入的数据已实施 WORM 锁定,则在映像清理作业期间,将相对于新截止日期重新评估对 WORM 保留锁定时间的任何更改。默认情况下,映像清理作业每 12 小时进行一次。运行 bpimage -allclients -cleanup 可立即启动映像清理作业。
仅当备份的所有副本都失效时,才能导入它。
有关如何导入备份的详细信息,请参见《NetBackup 管理指南,第 I 卷》。
选项
- -backupid backup_id
指定要导入的单个备份的备份 ID。
- -Bidfile file_name
file_name 指定一个文件,该文件包含要导入的备份 ID 的列表。在该文件中,每行列出一个备份 ID。如果包括该选项,则忽略其他选择条件。
此外,在激活该命令行界面 (CLI) 的过程中,NetBackup 还会删除通过 -Bidfile 参数指定的文件。之所以删除该文件是因为 NetBackup GUI 经常使用此参数。而这些 GUI 要求该命令行界面在操作完成后删除用于 -Bidfile 选项的临时文件。命令行界面的直接用户也可以使用此选项,但是此选项将删除该文件。
- -client name
对其执行备份的客户端的主机名。默认值为所有客户端。
- -cn copy_number
指定要导入的备份的源副本号。有效值介于 1 到 10 之间。默认值为所有副本。
- -create_db_info
该选项可为指定介质上的备份重新创建目录库条目。它将跳过目录库中已有的备份。仅创建作为导入对象的备份的相关信息,而且并不执行导入操作。导入任何备份之前,必须先运行带有该选项的 bpimport 命令。
- -dp disk_pool_name [-dv disk_volume]
仅导入指定磁盘池上的映像。此外,还可以仅导入驻留在指定磁盘卷上的映像。disk_volume 参数为 BasicDisk 的路径。
该选项要求使用 -stype 选项。
- -e enddate, -s startdate
为要导入的所有备份指定开始和结束日期范围。
s 指定列表的开始日期和时间。输出列表仅显示在指定日期和时间之后(包括在该日期和时间)生成的备份或存档中的映像。
-e 指定列表的结束日期和时间。输出列表仅显示在指定日期和时间之前(包括在该日期和时间)生成的备份或存档中的文件。所用的格式与开始日期格式相同。默认值是当前的日期和时间。
有效的日期范围为 01/01/1970 00:00:00 到 01/19/2038 03:14:07。默认值是前一天午夜 12 点。
NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。
/usr/openv/msg/.conf
文件 (UNIX) 和install_path\VERITAS\msg\LC.CONF
文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。有关系统区域设置的更多信息,请参见《NetBackup 管理指南,第 II 卷》中的“关于指定 NetBackup 安装的区域设置”。
以下是 -bpimport 的 -help 用法说明中显示 -s 和 -e 选项的部分:
-s mm/dd/yy [hh[:mm[:ss]]] -e mm/dd/yy [hh[:mm[:ss]]]
- -from_replica
仅扫描能够自动导入的映像并将其放置在存储生命周期策略自动导入工作表中。此选项是导入的阶段 1 的一部分。
- -hoursago hours
指定要搜索早于现在多少个小时之内的备份。不要与 -s 选项一起使用。默认值是前一天午夜 12 点。
- -id media_id | path
磁盘介质:指定包含要导入的备份的存储目录的 path。
磁带介质:对于步骤 1 (-create_db_info),此选项指定包含打算导入的备份的介质 ID。-create_db_info 要求使用该选项。
对于步骤 2,该选项可指定将从其导入备份的具体介质 ID。默认值是在导入操作的步骤 1 中处理的所有介质 ID。
如果在步骤 1 未处理的介质 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 选项”主题。
- -l
在列出所有已导入文件的进度日志中生成输出。
- -local
如果从主服务器以外的主机启动 bpimport 且未使用 -local(默认值),则会发生以下情况:bpimport 将在主服务器上启动该命令的远程副本。该远程副本允许从活动监视器终止该命令。
使用 -local 选项可阻止在主服务器上创建远程副本。还可以仅从启动 bpimport 的主机上运行该命令。如果使用了 -local 选项,将无法从活动监视器中取消 bpimport。
- -M master_server
注意:
鉴于 NetBackup 服务器只有一个服务器(主服务器),无需使用此选项。如果您确实要使用此选项,请指定运行该命令的 NetBackup 主服务器。
指定用于管理具有该介质 ID 的介质目录库的主服务器。如果未指定该选项,则默认值为以下服务器之一:
如果在主服务器上运行该命令,则该服务器为默认服务器。
如果在不是主服务器的介质服务器上运行该命令,则该介质服务器的主服务器为默认服务器。
- -p
根据选项设置来预览要导入的备份,但并不执行导入操作。显示介质 ID、服务器名称和有关要导入的备份的信息。
- -pb
预览要导入的备份,但不执行导入操作。该选项类似于 -p 选项,区别是不显示备份。
- -PD
该选项与 -PM 选项相同,只不过它按日期和时间对备份进行排序(从最新到最旧)。
- -PM
根据选项设置来显示有关要导入的备份的信息,但不执行导入操作。它会显示备份的日期和时间、策略、日程表、备份 ID、主机以及介质 ID。
- -policy name
在指定策略中搜索要导入的备份。默认值为所有策略。
- -priority number
为导入作业指定一个新优先级来覆盖默认作业优先级。
- -pt policy_type
搜索由指定的策略类型创建的备份。默认值为任意策略类型。
policy_type 为以下字符串之一:
Auspex-FastBackup DataStore DataTools-SQL-BackTrack DB2 Enterprise-Vault FlashBackup FlashBackup-Windows Informix-On-BAR LotusNotes MS-Exchange-Server MS-Hyper-V MS-SharePoint MS-SQL-Server MS-Windows NDMP Oracle PureDisk-Export SAP Split-Mirror Standard Sybase Vault VMware
- -server name
指定介质服务器的名称。对于包含要导入的备份的介质 ID,在该服务器的卷数据库中必须有它的记录。默认值是运行该命令的介质服务器。
注意:
NetBackup 服务器只有一个服务器(主服务器)。使用 NetBackup 服务器时,请指定该服务器的名称。
- -sl sched_label
搜索由指定日程表创建的要导入的备份。默认值为所有日程表。
- -st sched_type
搜索由指定日程表类型创建的要导入的备份。默认值为任意日程表类型。
有效值包括:
FULL(完全备份)
INCR(差异增量式备份)
CINC(累积增量式备份)
UBAK(用户备份)
UARC(用户存档)
NOT_ARCHIVE(除用户存档之外的所有备份)
- -stype server_type
指定标识存储服务器类型的字符串。server_type 值可能源自以下来源之一:
Veritas 提供的存储。可能的值有 AdvancedDisk 和 PureDisk。
第三方磁盘设备。供应商提供了 server_type 字符串。
云存储。使用 csconfig cldprovider -l 命令确定可能的 stype 值。云 stype 值反映了云存储提供程序。云存储 stype 值还可包含一个后缀(例如
amazon_crypt
)。可能的后缀是:_raw:将具有原始格式的 NetBackup 备份映像发送至云。如果您在将数据发送至云存储前不需要压缩或加密数据,则使用此选项。
_rawc:在将数据写入云存储之前压缩数据。
_crypt
:在将数据写入云存储之前使用 AES-256 加密对此数据进行加密。要使用此选项,必须在 NetBackup 中配置 KMS。_cryptc:将数据写入云存储之前压缩和加密数据。
存储服务器类型区分大小写。
- -v
在调试日志和进度日志中显示更多信息。
示例
示例 1 - 对介质 ID A0000 上的备份创建目录库信息(全部位于一行)。介质主机的主机名是 cat
。进度文件是 tmp 目录下的 bpimport.ls。
UNIX 系统:# bpimport -create_db_info -id A0000 -server cat -L /usr/openv/netbackup/logs/user_ops/bpimport.ls
Windows 系统:# bpimport -create_db_info -id A0000 -server cat -L c:\Program Files\Veritas\NetBackup\logs\user_ops\bpimport.ls
示例 2 - 显示有关要导入的备份的信息(全部位于一行)。所显示的备份是在 2012 年 11 月 1 日到 2012 年 11 月 10 日之间创建的。在运行此命令之前,必须先运行带有 -create_db_info 选项的 bpimport 命令。
# bpimport -PM -s 11/01/2012 -e 11/10/2012
示例 3 - 导入 images
文件中指定的备份。将在 bpimport.ls
文件中输入进度信息。
UNIX 系统:# bpimport -Bidfile /tmp/import/image -L /usr/openv/netbackup/logs/user_ops/bpimport.ls
Windows 系统:# bpimport -Bidfile \tmp\import\image -L c:\Program Files\Veritas\NetBackup\logs\user_ops\bpimport.ls
文件
UNIX 系统:
/usr/openv/netbackup/logs/admin/* /usr/openv/netbackup/db/images/*
Windows 系统:
install_path\NetBackup\logs\admin\* install_path\NetBackup\db\images\*