Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
bpplinfo — 管理或显示 NetBackup 的策略属性
大纲
policy_name -L | -l | -U [-v] [-M master_server,...]
policy_name -set | -modify [-v] [-M master_server,...] [-reason "string"] [-generation generation] [-active | -inactive] [-pt policy_type] [-job_subtype sub_type] [-ut] [-ef effective_time] [-residence label] [-pool label] [-priority number] [-rfile flag] [-blkincr flag] [-multiple_streams flag] [-keyword "keyword phrase"] [-encrypt flag] [-collect_tir_info value] [-compress flag] [-crossmp flag] [-follownfs flag] [-policyjobs max_jobs] [-chkpt flag] [-chkpt_intrvl interval] [-collect_bmr_info flag] [-application_consistent flag] [-sg server_group | *ANY* | *NONE*] [-data_class class | *NULL*] [-res_is_stl 0 | 1] [-granular_restore_info 0 | 1] [-ignore_client_direct 0 | 1] [-use_accelerator 0 | 1] [-application_discovery 0 | 1] [-discovery_lifetime seconds] [-ASC_apps_attr agent:[;truncatelogs=1|0],...] [-optimized_backup 0 | 1] [-ExchangeSource source [-Exchange2010Server server,... ]] [client_list_type type] [- selection_list_type type] [-application_defined value,...] [-dynamic_multi_streaming flag 0 | 1 [-max_streams_per_volume [1-20]] [-max_files_in_batch [1-2000]]] [-use_backup_host_pool flag 0 | 1 [-backup_host_pool "backup host pool name"]] [-use_vendor_change_tracking flag 0 | 1] [-ora_bkup_arch_file_name_fmt "[file_name_fmt]"] [-ora_bkup_ctrl_file_name_fmt "[file_name_fmt]"] [-ora_bkup_data_file_name_fmt "[file_name_fmt]"] [-ora_bkup_fra_file_name_fmt "[file_name_fmt]"] [-ora_bkup_set_id "[set_id]"] [-ora_bkup_data_file_args "[args]"] [-ora_bkup_arch_log_args "[args]"] [-snapshot_method_args keyword=value,keyword=value,...]
[-dynamic_multi_streaming flag 0 | 1 [-max_streams_per_volume number] [-max_files_in_batch number]] [-use_backup_host_pool flag 0 | 1 [-backup_host_pool "name"]] [-use_vendor_change_tracking flag 0 | 1]
policy_name -set | -modify -deployment_package item -deployment_media_server media_server [-deployment_limit_jobs max_concurrent_jobs] [-deployment_master_server master_server] [-deployment_use_existing_certs 0 | 1] [-deployment_cert_source (cert_store | file)] [ -deployment_components javagui_jre=(include | exclude | match)] [-deployment_unix_stage_loc path] [-deployment_win_stage_loc path] [-unix_eca_cert_path path] [-unix_eca_trust_store_path path] [-unix_eca_private_key_path path] [-unix_eca_crl_path path] [-unix_eca_key_passphrasefile path] [-unix_eca_crl_check_level (use_cdp | use_path | disabled)] [-win_eca_cert_path path] [-win_eca_trust_store_path path] [-win_eca_private_key_path path] [-win_eca_crl_path path] [-win_eca_key_passphrasefile path] [-win_eca_crl_check_level (use_cdp | use_path | disabled)] [-win_eca_cert_store path]
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
bpplinfo 初始化、修改或显示 NetBackup 策略的属性值。授权用户可启动此命令。
有关 NetBackup 授权的详细信息,请参见《NetBackup 安全和加密指南》。
bpplinfo 包括两种形式。用于 bpplinfo 的选项取决于所使用的 bpplinfo 的形式。
第一种形式的 bpplinfo 显示策略信息。-L、-l 和 -U 选项以不同的方式列出策略信息。
第二种形式的 bpplinfo 初始化或修改策略属性。
-set 将策略属性初始化或重新初始化为其默认值,但当前命令行上指定的属性除外。
-modify 修改当前命令行上指定的策略属性。不在当前命令行上的其他策略属性保持不变。
警告:
要修改策略属性,请使用 -modify 选项。此选项仅影响您在此命令行上指定的属性。请注意使用 -set 选项的方法,该选项将命令行上指定的属性以外的全部属性重置回其默认值。如果使用 -set 更改一个或两个属性,可能会无意中将所有未指定的属性返回到其默认值。
注意:
不建议用户修改或删除自动管理的策略。
如果用户修改策略,则必须确保策略继续满足保护计划定义的服务级别目标。
如果用户删除策略,则必须确保将资产添加到满足服务级别目标的其他保护计划。
选项
- policy_name -L | -l | -U
列出此策略的信息。必须指定此选项。
-L 指定长列表类型,并生成一个每行有一个策略属性的列表,格式为 policy_attribute: value。该值的形式可以是数值,也可以是名称。列表中的字段包括:
策略类型
策略生成(版本)
激活
遵循 NFS 装入(仅适用于 NetBackup Enterprise Server)
跨装入点
客户端压缩
收集 TIR 信息
策略优先级
扩展安全信息
还原为原始文件
客户端加密
每个策略的最多作业数
多个数据流
快照方法
快照方法参数
执行脱离主机备份
备份副本
使用数据移动器
数据移动器类型
使用备用客户端
备用客户端名称
使用虚拟机
Hyper-V 服务器
启用即时恢复
灾难恢复
收集 BMR 信息
最大片段大小
检查点重新启动
驻留位置
卷池
共享组
数据分类
驻留位置是存储生命周期策略
粒度还原
生成
备份主机池名称
使用供应商更改跟踪
动态多数据流
每卷最大数据流数
批处理的最大文件数
-l 指定短列表类型并生成简明列表。对于将列表内容重新编排成自定义的报告格式的脚本或程序,该选项很有用。短列表包含指定策略的以下信息:
第 1 行:"INFO",client_type、follow_nfs_mounts、client_compress、优先级、proxy_client、client_encrypt、灾难恢复、max_jobs_per_policy、cross_mount_points、max_frag_size、活动、collect_tir_info、block_incr、ext_sec_info、i_f_r_f_r、数据流、frozen_image、backup_copy、effective_date、策略 ID、number_of_copies、检查点、chkpt_interval、policy_info_unused1、pfi_enabled、offhost_backup、use_alt_client、use_data_mover、data_mover_type、collect_bmr_info、res_is_ss、granular_restore_info、job_subtype
第 2 行:"KEY",关键字
第 3 行:"BCMD",backup_command
第 4 行:"RCMD",restore_command
第 5 行:"RES",驻留位置
第 6 行:"POOL",池
第 7 行:"FOE",该字段未使用
-U 指定用户列表类型,并生成一个列表(每行有一个策略属性),格式为 policy_attribute: value。该列表与 -L 列表相似,但包含的字段较少。
- -v
选择详细模式。该选项可使 bpplinfo 记录供调试用的附加信息。这些信息记录在 NetBackup 每日管理调试日志中。该选项仅在 NetBackup 启用了调试日志功能(即定义了以下目录)的情况下才有意义:
UNIX 系统:/usr/openv/netbackup/logs/admin
Windows 系统:install_path\NetBackup\logs\admin
- -M master_server,...
备用主服务器的列表。这是一个以逗号分隔的主机名列表。如果包含该选项,则列表中的每台主服务器都会运行 bpplinfo 命令。列表中的每台主服务器必须允许发出 bpplinfo 命令的系统对其进行访问。如果任何主服务器发生错误,将在该位置处终止处理。
对于 bpplinfo 的显示形式,报告由该列表中所有主服务器返回的信息组成。bpplinfo 查询其中的每一台主服务器。主服务器返回其策略目录库中的信息。
对于 bpplinfo 的策略定义形式,策略是在列表中的每台主服务器上创建或修改的。
默认值为运行 bpplinfo 的系统的主服务器。
第二种形式的 bpplinfo 将初始化或修改策略的属性值。以下选项适用于这种形式:
注意:
并非所有的选项都适用于每种策略类型。例如,如果策略类型为 MS-Windows,则 bpplinfo 接受选项 -compress 和 -crossmp。当 bpplinfo 完成时,它返回 0 状态。但是,即使没有设置这些选项,NetBackup 也会处理策略类型为 MS-Windows 的策略。
- -active | -inactive
将策略设置为活动或不活动。如果策略是活动的,NetBackup 将运行它的所有自动日程表,并允许使用用户控制的备份和存档。仅当策略处于活动状态时,才会发生自动备份(默认设置)。
如果策略是不活动的,NetBackup 不会运行任何自动日程表,也不允许使用用户控制的日程表。如果需要临时停用某个策略以禁止使用日程表,此选项将非常有用。
- -application_consistent flag
指定在创建持久的硬件快照之前,将虚拟机置于静默模式 (flag=1)。否则,该硬件快照不会静默虚拟机 (flag = 0)(默认情况)。
- -application_defined value,...
此选项仅适用于 SQL Server 智能策略。client_list_type 必须设置为 1、2 或 3。为此选项定义的值适用于数据库操作,除非该值以 TL_ 开头。
VDI_TIMEOUT 除外。该值将应用于数据库备份和事务日志备份。
此选项可以使用一个或多个以下值:
STRIPES=value 或 TL_STRIPES=value - 将备份操作分割为多个并行流。一个流对应于活动监视器中的一个作业。例如,如果已设置 STRIPES=3,则将使用三个作业备份每个数据库。值范围是 1-32。默认值为 1。
BUFFERS=value 或 TL_BUFFERS=value - SQL Server 用于读取和写入备份映像的缓冲区大小。值范围是 1-32。默认值为 2。
MAX_TRANSFER_SIZE=value 或 TL_MAX_TRANSFER_SIZE=value - 指定 SQL Server 和 NetBackup SQL Agent 之间的 I/O 传输(缓冲区读写)的最大大小。计算为 64 KB * 2^MAX_TRANSFER_SIZE。值范围是 0-6 (64 KB-4 MB)。默认值是 6 (4 MB)。
BLOCK_SIZE=value 或 TL_BLOCK_SIZE=value - 设置 SQL Server 用于读取和写入备份映像且可以为每个备份操作设置的增量大小。所有数据传输是最大为 MAX_TRANSFER_SIZE 的值的倍数。计算为 512 字节 * 2^BLOCK_SIZE。值范围是 0-7 (512 B-64 KB)。默认值是 7 (64 KB)。
BATCH_SIZE=value 或 TL_BATCH_SIZE=value - 要同时启动的备份操作数。值范围是 1-32。默认值为 1。
CHECKSUM=0 | 1 | 2 或 TL_CHECKSUM=0 | 1 | 2 - 控制 SQL Server 是否执行备份校验和。默认值为 0。
0 = 未执行校验和。
1 = 已执行校验和,即使 SQL 检测到错误,备份也将继续进行。
2 = 已执行校验和,但如果检测到任何错误,备份将停止。
CONVERT_BACKUP=0 | 1 或 TL_CONVERT_BACKUP=0 | 1 - 如果数据库中不存在完全备份,则将差异式或事务日志备份转换为完全备份。
有关更多信息,请参见《NetBackup for SQL Server 管理指南》。
COMPRESSION=0 | 1 或 TL_COMPRESSION=0 | 1 - 控制是否使用 SQL Server 备份压缩。如果您启用 SQL Server 压缩,则不要启用 NetBackup 压缩。默认值为 0。
0 = 未启用压缩。
1 = 已启用压缩。
SKIP_OFFLINE=0 | 1 或 TL_SKIP_OFFLINE=0 | 1 - 控制代理如何处理数据库,并显示阻止 NetBackup 成功备份数据库的状态。这些状态包括脱机、还原、恢复和紧急模式等。启用此选项时,代理将跳过该数据库备份。NetBackup 不会记录这些数据库的错误。作业详细信息指示是否跳过数据库。默认值为 0。
0 = 未跳过脱机数据库,且为每个脱机数据库生成失败的作业。
1 = 已跳过脱机数据库,且未为跳过的数据库生成任何失败。
COPYONLY=0 | 1 - 此选项可以使 SQL Server 创建带外备份,以使它不影响正常的备份序列。除数据库的持久性冻结映像完全备份外,默认情况下为不选中。默认值为 0。
0 = 备份为非仅复制。
1 = 备份按仅复制形式执行。
SKIP_READONLY_FGS=0 | 1 - 此选项可以排除备份中只读的任何文件组。所生成的备份是一个部分映像,因为映像中并未包含所有文件组。默认值为 0。
0 = 未跳过只读文件组。
1 = 已跳过只读文件组。
TL_* - 包含 TL_* 的所有值与事务日志备份相对应(例如,运行事务日志日程表时)。
TL_TRUNCATE_LOGS=0 | 1 - 确定是否在备份结束时截断事务日志。默认值为 1。
0 = 未截断日志。
1 = 已截断日志。
PREFERRED_REPLICA - 确定如何执行实例或可用性组备份。
0 = 在指定的实例上执行备份。
1 = 始终在主副本上进行备份。
2 = 采用 SQL Server 备份首选项并保护首选副本。
3 = 跳过实例上的任何可用性数据库。
VDI_TIMEOUT - SQL Server 虚拟设备界面的超时间隔。所选间隔将应用于数据库备份和事务日志备份。范围值为 300–2147483647。默认值为 300。
- -application_discovery 0 | 1
为 vCloud Director 创建策略时,启用 VMware 策略可自动选择虚拟机进行备份。
- -ASC_apps_attr agent:[;truncatelogs=1|0],...
对 Exchange、SQL Server 或 SharePoint 的数据库数据启用文件级恢复。agent 值可以是
exchange
、mssql
或sharepoint
。可以为 Exchange 和 SQL Server 启用 (;truncatelogs=1) 和禁用 (;truncatelogs=0) 截断日志。
以下是显示如何使用此选项的几个示例:
启用 Exchange 文件恢复:-ASC_apps_attr exchange:
启用 Exchange、SQL Server 和 SharePoint 文件恢复:-ASC_apps_attr exchange:,mssql:,sharepoint:
启用 SQL Server 恢复并截断日志:-ASC_apps_attr mssql:;truncatelogs=1
截断 Exchange 日志但不截断 SQL Server 日志(请注意结尾冒号):-ASC_apps_attr exchange:;truncatelogs=1,mssql:
使用截断日志启用 Exchange 和 SQL Server:-ASC_apps_attr exchange:;truncatelogs=1,mssql:;truncatelogs=1
- -blkincr flag
注意:
仅当运行 NetBackup Enterprise Server 并且安装了 Veritas Oracle Edition(该版本支持块级增量式备份)时,此选项才适用。
值为 0(禁用)或 1(启用)。对该策略中的客户端执行块级增量式备份。
如果为 1,表示执行块级增量式备份。
如果为 0,表示禁用块级增量式备份。
- -client_list_type type
此选项用于 MS-SQL-Server 和 Oracle 策略。
如果为 0,则类型为 HOST。此策略是旧式 MS-SQL-Server 或 Oracle 策略。有效的日程表类型为 FULL 和 USER。
以下类型适用于 SQL Server 或 Oracle 智能策略。有效的日程表类型为 FULL、INCR 和 TLOG。
如果为 1,则类型为 INSTANCE,您可以将已注册的实例或实例中的数据库添加到策略中。
如果为 2,则类型为 INSTANCE_GROUP,您可以将已注册的实例组添加到策略中。
以下类型仅适用于 SQL Server 智能策略。
如果为 3,则类型为 AVAILABILITY_GROUP,并且可以将具有已注册副本的可用性组添加到策略中。
以下类型仅适用于 Oracle 智能策略。
如果为 4,则类型为 RAC_DATABASE,并且备份的客户端类型为 Oracle RAC。
- -chkpt [1|0]
启用和禁用策略的检查点重新启动。如果为 1,此命令将启用检查点重新启动。如果为 0,此命令将禁用检查点重新启动。默认值为 0。
- -chkpt_intrvl interval
启用和禁用策略的检查点间隔。变量 interval 是检查点间隔(以分钟为单位)。默认间隔为 15 分钟。此间隔的范围在 5 到 180 分钟之间。如果未启用检查点重新启动,则此参数无效。
- -collect_tir_info value
收集实际映像恢复 (TIR) 信息。使用实际映像恢复,NetBackup 可以将目录还原到执行任何预定的完全备份或增量式备份时它所在的确切位置。系统不会还原选定的备份时间之前删除的文件。启用此属性后,NetBackup 将开始收集其他信息。并从策略的下一次完全备份或增量式备份开始。
如果为 0,表示 NetBackup 不跟踪实际映像恢复信息。
如果为 1,表示 NetBackup 收集 TIR 信息。
如果为 2,表示 NetBackup 收集 TIR 信息并跟踪客户端文件。
- -collect_bmr_info flag
收集 Bare Metal Restore 信息。
如果 flag 为 0,则表示不收集 Bare Metal Restore 信息。
如果 flag 为 1,则表示收集 Bare Metal Restore 信息。
如果将 -collect_bmr_info 设置为 1 并且没有 Bare Metal Restore 的使用许可,或者策略类型不是 Standard 或 MS-Windows,则 bpplinfo 将失败。
如果将 -collect_bmr_info 设置为 1,但策略不使用移动检测来收集实际映像还原信息,则 Bare Metal Restore 将忽略以下操作:增量式备份,并从上次完全备份中还原文件。
- -compress flag
指定是否压缩文件。如果设置为 1(启用),客户端软件会将选定文件压缩到介质上。压缩可缩小备份文件的大小以及所需的存储介质,但可能会增加总备份时间。如果设置为 0(禁用),则不会将文件压缩到介质上(默认情况)。请注意,该压缩与 VxFS 压缩无关。
该选项对存储单元中可以使用的硬件压缩不起作用。
- -crossmp flag
值为 0(禁用)或 1(启用)。指定在备份期间是否跨装入点。
如果为 1,表示 NetBackup 将备份或存档所选路径中的所有文件和目录,无论它们位于何种文件系统中。
如果为 0,则表示 NetBackup 只备份或存档与所选文件路径位于同一文件系统中的文件和目录(默认值)。
此属性可能会影响“遵循 NFS”策略属性,后者仅适用于 NetBackup Enterprise Server。
有关跨装入点属性的更多信息,请参见《NetBackup 管理指南,第 I 卷》。
- -data_class class
指定数据分类(例如,黄金级别或铂金级别)。
- -deployment_cert_source (cert_store | file)
使用此选项可为 Windows 主机指示证书来源。使用 -deployment_cert_source cert_store 可指示 Windows 证书存储库。使用 -deployment_cert_source file 可指示证书位于文件中。如果使用 -win_eca_cert_store 选项,则必须指定 -deployment_cert_source cert_store。在所有其他情况下,使用 -deployment_cert_source file。
- -deployment_components javagui_jre=(include | exclude | match)
使用此选项可指定在部署作业运行后,目标系统上是否应存在 Java GUI 和 JRE。
值为 include 指示您希望在目标系统上安装或升级这些组件。
值为 exclude 指示您不希望目标系统上存在这些组件。任何已有的 Java GUI 和 JRE 组件都将被删除。
值为 match 指示您希望保留 Java GUI 和 JRE 组件的当前状态。如果预升级的系统上存在这些组件,则会升级这些组件。如果预升级的系统上不存在这些组件,则不会安装这些组件。
- -deployment_limit_jobs max_concurrent_jobs
每个策略允许的最大作业数。此选项只能与 Deployment 策略类型结合使用。
- -deployment_master_server master_server
如果客户端有多台主服务器,master_name 值为包含存储库的主服务器。此选项只能与 Deployment 策略类型结合使用。
- -deployment_media_server media_server
与之通信并将软件包部署到策略客户端的介质服务器的名称。软件包缓存在介质服务器上,以最大限度地减少通信并提高性能。软件包存储库驻留在主服务器上。此选项只能与 Deployment 策略类型结合使用。
- -deployment_package item
要安装的软件包的名称。此选项只能与 Deployment 策略类型结合使用。
- -deployment_unix_stage_loc path
用于为 UNIX 或 Linux 客户端指定备用分段位置。当前未使用。
- -deployment_use_existing_certs 0 | 1
使用此选项可指定是否要在安装时使用现有证书(如果可用)。使用 1 将启用此选项,使用 0 将禁用此选项。
- -deployment_win_stage_loc path
用于为 Windows 客户端指定备用分段位置。当前未使用。
- -disaster 0 | 1
收集智能灾难恢复所需的信息。仅当备份 Windows 客户端时,该属性才适用。
0 = 不允许灾难恢复(默认值)
1 = 允许灾难恢复
- -discovery_lifetime seconds
指定重用 VM 选择查询结果的时间(秒)。
- -dynamic_multi_streaming flag 0 | 1
为 NAS-Data-Protection 策略类型启用动态多数据流。如果值为 1,则允许动态多数据流,值为 0 则不允许动态多数据流。
-max_streams_per_volume number:指定每个卷的最大数据流数(介于 1 到 20 之间)。默认值为 2。
-max_files_in_batch number:指定批处理中的最大文件数(介于 1 到 2000 之间)。默认值为 500。
- -ef effective time
此时间指定策略处于活动状态的时间。
- -encrypt flag
指定是否应加密文件。如果将 flag 设置为 1,将启用加密。
- -Exchange2010Server server,...
对于 Exchange DAG,是 DAG 中您选择作为首选备份源的一个或多个服务器的列表。如果 -ExchangeSource 为 1,则需要首选服务器列表,除非数据库只有一个主动副本。如果 -ExchangeSource 为 2,将忽略该列表,如果 -ExchangeSource 为 0,则该列表是可选的。
- -ExchangeSource source
指明希望 Exchange 数据库可用性组 (DAG) 使用的数据库备份源。默认值为 0。该选项的可能值如下:
0 - 备份数据库的被动副本或被动服务器。对于 DAG,还可以配置首选服务器列表。NetBackup 将备份首选服务器列表中服务器上的被动副本。如果被动副本不可用,NetBackup 将备份主动副本。
1 - 备份数据库的被动副本或被动服务器。对于 DAG,还必须配置首选服务器列表。NetBackup 将备份首选服务器列表中服务器上的被动副本。
2 - 备份数据库的主动副本或主动节点。对于 Exchange 2010 和更高版本,将忽略首选服务器列表。
3 - 禁用数据库备份源。
- -follownfs flag
注意:
此选项仅适用于 NetBackup Enterprise Server。
值为 0(禁用)或 1(启用)。指定是否遵循 NFS 装入点。对于 MS-Windows 策略类型,设置该标志会影响策略属性“备份网络驱动器”,而不会影响“遵循 NFS”属性。
如果为 1,表示 NetBackup 将备份或存档所遇到的所有 NFS 装入的文件。
如果为 0,表示 NetBackup 不备份或存档所遇到的任何 NFS 装入的文件(默认值)。
该属性的行为随“跨装入点”属性设置的不同而有所不同。
有关跨装入点属性的更多信息,请参见《NetBackup 管理指南,第 I 卷》。
- -granular_restore_info flag
启用或禁用了粒度恢复属性,该属性可还原数据库备份映像中的各个对象。该属性适用于 MS-Exchange_Server、MS-SharePoint 和 MS-Windows(针对 Active Directory)。
如果为 1,将显示粒度还原信息。
如果为 0,则不会显示粒度还原信息。
有关粒度还原的更多信息,请参见 NetBackup for Exchange 管理指南,第 I 卷。
- -ignore_client_direct 0 | 1
启用 (0) 或禁用 (1) 客户端重复数据删除。
- -job_subtype DUPLICATE | LIVEUPDATE, INDEXING
允许显示“复制”功能或 LiveUpdate 功能的常规策略。默认情况下,不显示这两项功能的策略。
- -keyword "keyword phrase"
该值将与使用该策略创建的所有备份相关联。关键字短语可用于链接相关策略。也可以在还原期间使用,以便仅搜索与关键字短语关联的备份。
- -M master_server,...
与前面的说明相同。
- -multiple_streams flag
值为 0(禁用)或 1(启用)。允许多个数据流。
如果为 1,表示允许多个数据流。
如果为 0,表示禁用多个数据流。
- -optimized_backup 0 | 1
对某些 Microsoft Windows 操作系统版本提供的进行重复数据删除的数据启用备份。如果客户端已配置进行重复数据删除的文件系统,NetBackup 将备份进行重复数据删除的数据。如果客户端未设置进行重复数据删除或不支持重复数据删除,将进行正常文件备份。
- -ora_bkup_arch_file_name_fmt "[file_name_fmt]"
指定已存档的重做日志的 Oracle RMAN 备份片名称。保证格式以 _%t 结尾以指示时间戳。NetBackup 将此时间戳用作目录库映像搜索条件的一部分。如果没有此时间戳,随着 NetBackup 目录库的扩展,性能可能会下降。
为 file_name_fmt 指定空字符串 ("") 以产生要使用的默认格式。
- -ora_bkup_ctrl_file_name_fmt "[file_name_fmt]"
指定控制文件的 Oracle RMAN 备份片名称。保证格式以 _%t 结尾以指示时间戳。NetBackup 将此时间戳用作目录库映像搜索条件的一部分。如果没有此时间戳,随着 NetBackup 目录库的扩展,性能可能会下降。
为 file_name_fmt 指定空字符串 ("") 以产生要使用的默认格式。
- -ora_bkup_data_file_name_fmt "[file_name_fmt]"
指定数据文件的 Oracle RMAN 备份片名称。保证格式以 _%t 结尾以指示时间戳。NetBackup 将此时间戳用作目录库映像搜索条件的一部分。如果没有此时间戳,随着 NetBackup 目录库的扩展,性能可能会下降。
为 file_name_fmt 指定空字符串 ("") 以产生要使用的默认格式。
- -ora_bkup_fra_file_name_fmt "[file_name_fmt]"
指定快速恢复区域 (FRA) 的 Oracle RMAN 备份片名称。保证格式以 _%t 结尾以指示时间戳。NetBackup 将此时间戳用作目录库映像搜索条件的一部分。如果没有此时间戳,随着 NetBackup 目录库的扩展,性能可能会下降。
为 file_name_fmt 指定空字符串 ("") 以产生要使用的默认格式。
- -ora_bkup_arch_log_args "[key=value,...]"
key=value 对将用于覆盖默认的参数,这些参数会在使用 RMAN 备份 Oracle 已存档的重做日志时使用。未显式指定的任何密钥将重置为默认值。指定一个空字符串 ("") 将所有密钥重置为默认值。使用逗号 (,) 分隔密钥值对。不允许使用空格。下面是密钥及其值:
INCLUDE_ARCH_LOGS - 在完整和增量式日程表备份中包括已存档的重做日志。有效值是 0 和 1,默认值是 1。
DELETE_ARCH_LOGS_AFTER_COPIES - 在成功备份已存档的重做日志一次或多次后删除这些日志。可忽略该密钥或将密钥设置为 0,以便备份后不删除日志。默认值为 0。
NUM_STREAMS - 可在备份操作中使用的并行备份流的数目。将指示 RMAN 为每一条流分配并行通道。默认值为 1。
SPECIFY_MAX_LIMITS - 必须启用以修改这些其他密钥。有效值是 0 和 1,默认值是 0。
NUM_FILES_PER_BACKUP_SET - 指定在每个备份集 (FILESPERSET) 中最多可包括的已存档重做日志文件的数目。如未指定,则采用 RMAN 默认值。
SIZE_BACKUP_SET - 指定每一个备份集的最大大小(以千字节为单位)(MAXSETSIZE)。如未指定,则采用 RMAN 默认值。
- -ora_bkup_data_file_args "[key=value,...]"
指定将用于覆盖默认参数的 key=value 对,这些参数会在使用 RMAN 备份 Oracle 数据文件时使用。未显式指定的任何密钥将重置为默认值。指定一个空字符串 ("") 将所有密钥重置为默认值。使用逗号 (,) 分隔密钥值对。不允许使用空格。下面是密钥及其值:
NUM_STREAMS - 可在备份操作中使用的并行备份流的数目。将指示 RMAN 为每一条流分配并行通道。默认值为 1。
SKIP_READ_ONLY or FORCE_READ_ONLY - 启用只读表空间选项。“跳过”选项会在备份期间忽略只读表空间。“强制”表示 RMAN 备份所有文件。只能并行启用两个中的其中一个。有效值是 0 和 1,默认值是 0。
OFFLINE - 关闭 Oracle 数据库,并在备份之前将其置于装入状态。有效值是 0 和 1,默认值是 0。
SKIP_OFFLINE - 指示备份操作不访问脱机数据文件。有效值是 0 和 1,默认值是 0。
SPECIFY_MAX_LIMITS - 必须启用以修改这些其他密钥。有效值是 0 和 1,默认值是 0。
READ_RATE - 指定在此通道上 RMAN 每秒读取的最大千字节数 (KB) (RATE)。此参数设置读取的字节上限以免 RMAN 占用过多的磁盘带宽而使性能下降。如未指定,则采用 RMAN 默认值。
SIZE_BACKUP_PIECE - 指定在此通道上创建的每个备份片的最大大小(以千字节为单位)(MAXPIECESIZE)。如未指定,则采用 RMAN 默认值。
NUM_OPEN_FILES – 控制在任何给定时间备份操作最多可以打开的输入文件的数目 (MAXOPENFILES)。如未指定,则采用 RMAN 默认值。
NUM_FILES_PER_BACKUP_SET - 指定在每个备份集 (FILESPERSET) 中最多可包括的输入文件的数目。如未指定,则采用 RMAN 默认值。
SIZE_BACKUP_SET - 指定每一个备份集的最大大小(以千字节为单位)(MAXSETSIZE)。如未指定,则采用 RMAN 默认值。
- policy_name -set | -modify
初始化或修改此策略的属性。必须指定此选项。
-set 将该策略的属性初始化(或重新初始化)为其默认值,但由当前命令行上的选项设置的属性除外。
-modify 修改策略的属性。对于不是由当前命令行上的选项显式设置的属性,不要改变它们的值。
- -policyjobs max_jobs
NetBackup 允许此策略具有的最多并行作业数(对应于管理界面中的“限制每个策略的作业数”设置)。max_jobs 的值始终大于或等于 0。
对于默认值或当 -policyjobs 为 0 时,bpplinfo 将 max_jobs 设置为一个无限制的值。NetBackup 的最多作业数是 8,而 NetBackup Enterprise Server 的最多作业数是 999。
- -pool label
指定策略的卷池。默认为 NetBackup。该卷池应该是策略存储单元的卷池之一。如果磁盘存储单元是策略的驻留位置,则该属性无效。如果策略存储单元为 Any_available(驻留位置:出现在 bpplinfo 的显示内容中),可选择任何存储单元的卷池。如果指定 *NULL*,则将卷池设置为 NetBackup。要显示配置的卷池,请运行以下命令:
UNIX 系统:/usr/openv/volmgr/bin/vmpool -listall
Windows 系统:install_path\Volmgr\bin\vmpool -listall
- -priority number
该策略相对于其他策略的优先级。优先级大于或等于 0。该值决定策略的运行顺序。值越大,表示策略运行时间越早。默认值为 0,它是最低的优先级。
- -pt policy_type
输入以下字符串之一以指定策略类型(默认为 Standard):
BigData DataStore DataTools-SQL-BackTrack DB2 Deployment Enterprise-Vault FlashBackup Hyper-V Informix-On-BAR Lotus-Notes MS-Exchange-Server MS-SharePoint MS-SQL-Server MS-Windows NAS-Data-Protection NBU-Catalog NDMP Oracle PureDisk-Export SAP Split-Mirror Standard Sybase Vault VMware
- -reason "string"
指示您选择此命令操作的原因。您输入的原因文本字符串将被捕获并显示在审核报告中。用双引号 ("...") 将此字符串括起来。该字符串不能超过 512 个字符。该字符串不能以短划线字符 (-) 开头,也不能包含单引号 (')。
- -res_is_stl 0 | 1
仅当存储单元的名称和存储生命周期策略的名称相同时才指定此标志。在其他所有情况下,将忽略此标志。可能值如下所述:
0 - 驻留位置为非存储生命周期策略
1 - 驻留位置为存储生命周期策略
- -residence label
指定存储单元的标签,该存储单元用来存储按照该日程表创建的备份。默认值 Any_available 允许策略使用其属性“只根据要求”设置为“否”的存储单元。如果策略必须使用特定的存储单元,请指定存储单元。如果“只根据要求”属性设置为“是”,则必须选择所需的存储单元。如果指定 *NULL*,则会将该日程表的驻留位置设置(或重置)为 Any_available。除非个别日程表的 设置指定了驻留位置,否则由该策略的驻留位置决定策略日程表的驻留位置。运行 bpstulist 可显示一组已定义的存储单元。
- -rfile flag
值为 0(禁用)或 1(启用)。
如果为 1,表示允许从原始文件还原单个文件。
如果为 0,表示禁用从原始文件还原单个文件。
对于 FlashBackup 策略,将忽略该选项,原因是此策略始终启用该属性。
注意:
仅当运行 NetBackup Enterprise Server 并且安装了单独购买的选件时,Advanced Client 才可用。
- -selection_list_type type
此选项用于 MS-SQL-Server 策略。您选择的值确定了备份选择的类型或可以使用 bpplinclude 命令添加的文件列表项。
如果为 0,则类型为 HOST。此类型只能与旧式 MS-SQL-Server 策略一起使用。对该类型有效的唯一备份选择是备份批处理文件的路径。
以下类型仅适用于 SQL Server 智能策略。
如果为 1,则类型为 WHOLE_DATABASE。对该类型有效的唯一备份选择是 WHOLE_DATABASE。
如果为 3,则类型为 DATAFILE。对该类型有效的唯一备份选择是文件的名称。
如果为 7,则类型为 FILEGROUP。对该类型有效的唯一备份选择是文件组的名称。
- -sg [server_group | *ANY* | *NONE*]
指定该日程表的服务器组。如果日程表位于磁盘存储单元上,请不要使用此选项。如果指定了 *NONE*,则表示写入介质服务器拥有此策略所写入的介质。如果指定了 *ANY*,EMM 将选择介质所有者。*ANY* 是默认值。否则,将由指定的共享组拥有介质。指定每个副本的共享组,以显示所配置的共享组。输入以下命令:
UNIX 系统:
/usr/openv/netbackup/bin/admincmd/nbsvrgrp -list -summary
Windows 系统:
install_path\NetBackup\bin\admincmd\nbsvrgrp -list -summary
- -snapshot_method_args keyword=value,keyword=value,...
指定 VMware 策略快照方法的参数。以下是可指定的关键字及其值:
disable_quiesce。快照过程中虚拟机 I/O 的状态。下面是允许的值:
0(启用虚拟机静默)或 1(禁用虚拟机静默)。
小心:
Veritas 建议您不要禁用静默。在大多数情况下,应启用此选项。
注意:
要使用此选项,必须在虚拟机上安装 VMware Tools。
注意:
要对 Linux 虚拟机使用此选项,还必须安装 SYMCquiesce 实用程序。
drive_selection。对于具有多个虚拟磁盘的虚拟机,需确定备份中包括的虚拟机磁盘类型。此选项可以减小备份的大小,但是应该小心使用。下面是允许的值:
0(包括所有磁盘)、1(排除引导磁盘)或 2(排除数据磁盘)。
enable_vCloud。启用驻留在 vCloud 环境中的虚拟机的备份。需要虚拟机的自动选择。下面是允许的值:
0(禁用)或 1(启用)。
exclude_swap。从备份中排除交换文件和分页文件的数据。如果文件已还原,它们会还原为空文件。下面是允许的值:
0(禁用)或 1(启用)。
file_system_optimization。通过排除虚拟机上文件系统中所有未使用的或已删除的块,减小备份映像的大小。此选项支持以下文件系统:Windows NTFS 以及 Linux ext2、ext3 和 ext4。下面是允许的值:
0(禁用)或 1(启用)。
ignore_irvm。如果虚拟机从 NetBackup NFS Datastore 运行,则忽略使用 VMware 即时恢复还原的所有虚拟机。下面是允许的值:
0(禁用)或 1(启用)。
multi_org。允许查询规则从不同的 vCloud Director 组织中选择虚拟机,然后将其备份到同一存储单元。下面是允许的值:
0(禁用)或 1(启用)。
nameuse。NetBackup 在选择虚拟机进行备份时用于识别这些虚拟机的名称类型。下面是允许的值:
0(VM 主机名)、1(VM 显示名称)、2 (VM BIOS UUID)、3(VM DNS 名称)或 4(VM 实例 UUID)
post_events。将备份相关事件发送到 vCenter Server。要向 vCenter 发布事件,NetBackup 必须通过 vCenter Server 执行备份。如果 NetBackup 直接访问 ESX Server,备份信息将无法显示在 vSphere Client 中。必须在 vCenter 中设置以下权限:“记录事件”、 和 。下面是允许的值:
0(无事件)、1(所有事件)或 2(错误事件)。
rHz。重试快照前的等待时间(秒)。默认值为 10 秒。下面是允许的值:
0 到 3600(含两端值)。
rLim。重试快照的次数。默认值为 10。下面是允许的值:
0 到 100(含两端值)。
rTO。完成快照的超时期限(分钟)。默认值为 0,表示没有超时。下面是允许的值:
0 到 1440(含两端值)。
serverlist. 此策略与 NetBackup 通信的虚拟机服务器列表(以冒号分隔)。要指定无服务器列表,请输入 serverlist=。
skipnodisk。不会在 vCenter Site Recovery Manager (SRM) 环境中备份复制(被动)的 VM,如果该 VM 没有 vmdk 文件。NetBackup 跳过该 VM,然后备份具有 vmdk 文件的对应活动 VM。下面是允许的值:
0(禁用)或 1(启用)。
snapact。此选项指定 NetBackup 在为虚拟机备份创建新快照之前发现快照时 NetBackup 执行的操作。创建快照后,NetBackup 通常会在备份完成时删除该快照。如果未自动删除快照(不论是否由 NetBackup 创建),虚拟机的性能可能最终会下降。下面是允许的值:
0(继续备份)、1(如果存在任何快照则中止)、2(删除 NetBackup 快照并继续备份)或 3(如果存在 NetBackup 快照则中止)。
trantype. 快照数据从 VMware DataStore 传送到 VMware 备份主机的方式。下面是允许的值:
san、hotadd、nbd 或 nbdssl。
要指定多种传输方法,则用冒号分隔。模式顺序指示优先级。例如,以下规范选择两种模式并首先尝试 nbd:
trantype=nbd:hotadd
Virtual_machine_backup。允许从备份还原单个文件。无论是否使用此选项,都可以还原整个虚拟机。下面是允许的值:
1(禁用)或 2(启用)
vmdk_ca。VMware 自定义属性的名称,用于指定从备份中排除的一个或多个磁盘。例如,vmdk_ca=NB_DISK_EXCLUDE_LIST。
根据需要在每个虚拟机或受管主机上设置该属性的值。该属性必须具有逗号分隔的设备控制器值,才可排除磁盘。例如:scsi0-0,ide0-0,sata0-0。
vmdk_list。要从 VMware 备份中排除的磁盘的以冒号分隔的设备控制器值。例如: vmdklist=scsi0-0:ide0-0:sata0-0。
- -unix_eca_cert_path path
使用此选项可为 UNIX 和 Linux 主机指定证书文件路径和证书文件名称。
- -unix_eca_crl_check_level (use_cdp | use_path | disabled)
指定要在 UNIX 和 Linux 主机上处理证书吊销列表的方式。指定 use_cdp 以使用证书中定义的 CRL。指定 use_path 以指定 CRL 路径。指定 disabled,从而不使用 CRL。
- -unix_eca_crl_path path
使用此选项可为 UNIX 和 Linux 主机指定外部证书颁发机构文件的路径。如果使用 -unix_eca_crl_check_level use_path 选项,则需要使用此选项。
- -unix_eca_key_passphrasefile path
使用此选项可提供 UNIX 和 Linux 主机上的密码文件路径。此选项不是必需的。
- -unix_eca_private_key_path path
使用此选项可指定 UNIX 和 Linux 主机上的私钥文件路径和私钥文件名。
- -unix_eca_trust_store_path path
您可以使用此选项指定 UNIX 和 Linux 主机上的信任存储区路径和信任存储区文件名。
- -use_accelerator 0 | 1
指定您希望使用 NetBackup 加速器,该加速器可以通过客户端上的更改检测技术提高完全备份的速度。
如果为 1,将启用 NetBackup 加速器。
如果为 0,将禁用 NetBackup 加速器。
有关 NetBackup Accelerator 的更多信息,请参见《NetBackup 管理指南,第 I 卷》。
- -use_backup_host_pool flag 0 | 1
指定是否希望 NetBackup 使用备份主机池。备份主机池是用于备份的一组主服务器或介质服务器。如果值为 1,则允许使用备份主机池。如果值为 0,则禁止使用备份主机池。在启用 -use_backup_host_pool 后,使用 -backup_host_pool name 选项指定备份主机池名称。
- -use_vendor_change_tracking flag 0 | 1
为增量式备份启用供应商更改跟踪。指定 1 可允许对增量式备份进行供应商更改跟踪。如果值为 0,将不允许对增量式备份进行供应商更改跟踪。
- -ut
如果 -ut 后面跟有任何日期或时间参数,系统将按 UNIX 时间(而不是标准时间格式)接受这些参数。-ut 选项主要用于 Java。
- -win_eca_cert_path path
使用此选项可为 Windows 主机指定证书文件路径和证书文件名。
- -win_eca_cert_store path
使用此选项可指定 Windows 证书存储库路径。必须以 Certificate_Store_Name\Issuer_Distinguished_Name\Subject_Distinguished_Name 方式输入证书位置。
- -win_eca_crl_check_level (use_cdp | use_path | disabled)
指定要在 Windows 主机上处理证书吊销列表的方式。指定 use_cdp 以使用证书中定义的 CRL。指定 use_path 以指定 CRL 路径。指定 disabled,从而不使用 CRL。
- -win_eca_crl_path path
使用此选项可为 Windows 主机指定外部证书颁发机构文件路径。如果使用 -win_eca_crl_check_level use_path 选项,则需要使用此选项。
- -win_eca_key_passphrasefile path
使用此选项可提供 Windows 主机上的密码文件路径。此选项不是必需的。
- -win_eca_private_key_path path
使用此选项可指定 Windows 主机上的私钥文件路径和私钥文件名。
- -win_eca_trust_store_path path
您可以使用此选项指定 Windows 主机上的信任存储区路径和信任存储区文件名。
示例
注意:
以下示例中提到的 NFS 装入仅适用于 NetBackup Enterprise Server。
示例 1 - 将策略 tstpolicy 的存储单元设置为 tstunit 并查看结果:
# bpplinfo tstpolicy -modify -residence tstunit # bpplinfo tstpolicy -L Policy Type: Standard (0) Active: no Effective: no Follow NFS Mounts: no Cross Mount Points: no Client Compress: no Collect TIR Info: no Policy Priority: 0 Ext Security Info: no File Restore Raw: no Client Encrypt: no Max Jobs/Policy: 8 Mult. Data Streams: 1 Block Level Incremental: no Perform Snapshot Backup: no Backup Copy: 0 Date Mover Type: 2 Use Alternate Client: no Alternate Client Name: (none) Enable Instant Recovery: no Disaster Recovery: 0 Collect BMR Info: no Max Frag Size: 0 MB (1048576 MB) Checkpoint Restart: no Residence: tstunit Volume Pool: NetBackup Use Backup Host Pool: no Backup Host Pool Name: (none) Use Vendor Change Tracking: no Dynamic Multi-Stream: no Max Streams/Volume: 4 Max Files in batch: 300
示例 2 - 要不修改其他任何策略属性且激活名为 test1 的策略,请输入以下命令:
# bpplinfo test1 -modify -active
示例 3 - 要将策略 tstpolicy 的属性重新设置为默认值,请执行下面的命令:
# bpplinfo tstpolicy -set # bpplinfo tstpolicy -L Policy Type: Standard (0) Active: yes Follow NFS Mounts: no Cross Mount Points: no Client Compress: no Collect TIR Info: no Policy Priority: 0 Ext Security Info: no File Restore Raw: no Client Encrypt: no Multiple Streams: 0 Disaster Recovery: 0 Max Jobs/Policy: 8 Disaster Recovery: 0 Collect BMR Info: no Max Frag Size: 0 MB (1048576 MB) Residence: - Volume Pool: NetBackup
示例 4 - 显示名为 mkbpolicy 的策略的短列表:
# bpplinfo mkbpolicy -l INFO 0 0 0 0 *NULL* 0 0 99 0 0 0 0 0 0 0 0 *NULL* 1 KEY my temp directory BCMD *NULL* RCMD *NULL* RES mkbunit *NULL* *NULL* *NULL* *NULL* *NULL* *NULL* *NULL* *NULL* POOL NetBackup *NULL* *NULL* *NULL* *NULL* *NULL* *NULL* *NULL* *NULL* FOE 0 0 0 0 0 0 0 0 0 0
示例 5 - 配置名为 mypolicy 的 Oracle 策略。此示例可针对数据文件备份并行使用两个 RMAN 通道。此示例还会跳过只读数据文件,并在每一个备份集中包含不超过 4 个文件。请记住,未显式设置的任何密钥将自动重置为默认值。之后确认更改。
# bpplinfo mypolicy –modify –ora_bkup_data_file_args NUM_STREAMS=2, SKIP_READ_ONLY=1,FORCE_READ_ONLY=0,SPECIFY_MAX_LIMITS=1, NUM_FILES_PER_BACKUP_SET=4
# bpplinfo mypolicy –L Oracle Backup Data File Arguments: NUM_STREAMS=2, SKIP_READ_ONLY=1,FORCE_READ_ONLY=0,SPECIFY_MAX_LIMITS=1, NUM_FILES_PER_BACKUP_SET=4
文件
UNIX 系统:
/usr/openv/netbackup/logs/admin/* /usr/openv/netbackup/db/policy/policy_name/info
Windows 系统:
install_path\NetBackup\logs\admin/* install_path\NetBackup\db\policy\policy_name\info