Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
bpplinclude — 维护由 NetBackup 策略自动备份的文件列表
大纲
policy_name [-v] [-M master_server,...] -L | -l [-generation generation] [-exclude_volumes]
policy_name [-v] [-M master_server,...] [-generation generation] -add pathname or directive ... | -add -f filename | -addtoquery query_string... -addtoquery -f filename | -delete pathname or directive ... | -delete -f filename | -deletefromquery query_string... | -deletefromquery -f filename | -modify old_pathname new_pathname ... [-reason "string"] [-exclude_volumes]
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
bpplinclude 维护 NetBackup 策略的策略文件列表。策略文件列表是 NetBackup 为策略运行自动备份时备份的文件列表。策略文件列表不适用于用户备份或存档,原因是用户在开始执行这些操作时会选择这些文件。
bpplinclude 执行以下操作之一:
将指定路径名添加到策略文件列表中
从策略文件列表中删除路径名
修改策略文件列表中的路径名
显示策略的策略文件列表
从策略中排除指定的卷。此选项仅适用于 NAS-Data-Protection 策略类型。
对于大多数策略,-add、-delete 和 -modify 选项包括一个路径名列表。路径名列表必须是 bpplinclude 命令行的最后一部分。路径名必须是从文件系统的根到所需位置的完整路径。
有关客户端类型的路径名语法,请参见《NetBackup 管理指南,第 I 卷》。
路径的最后一部分可以是文件名、目录名或通配符指定项。可以将路径名放在引号内。如果路径名包含特殊字符或通配符指定项,则必须使用引号。
文件路径规则不检验输入目录或文件是否存在。NetBackup 只备份它找到的文件,并且不要求列表中的所有条目都存在于每个客户端上。
对于大多数数据库代理,输入条目是脚本或指令。有关其他信息,请参见数据库代理产品附带的 NetBackup 指南。另请参见 -add pathname 选项。
添加到策略文件列表的条目可以是某些策略属性(例如“允许多个数据流”)和附加产品(例如 NetBackup for NDMP)的指令,但不能是它们的路径名。
请参见《NetBackup 管理指南,第 I 卷》或针对扩展产品的 NetBackup 指南。
选项 -l 和 -L 显示的策略文件列表几乎相同。
bpplinclude 将它的错误消息发送到 stderr,并将它的活动日志发送到当天的 NetBackup 管理日志文件中。
授权用户可启动此命令。
有关 NetBackup 授权的详细信息,请参见《NetBackup 安全和加密指南》。
注意:
不建议用户修改或删除自动管理的策略。
如果用户修改策略,则必须确保策略继续满足保护计划定义的服务级别目标。
如果用户删除策略,则必须确保将资产添加到满足服务级别目标的其他保护计划。
选项
- -add pathname ...
将指定的 pathname 添加到策略文件列表中。pathname 可以是目录、文件名、脚本或指令。
如果路径名包含特殊字符(如空格“ ”)或通配符指定项,则必须将路径名放在引号 (") 内。请使用空格而不是逗号来分隔两个路径名。bpplinclude 将逗号解释为路径名的一部分;因此,会将两个或多个以逗号分隔的路径名连接成包含内嵌逗号的单个路径名。该命令不验证路径名的语法或路径名是否存在。
对于 MS-SQL-Server 智能策略,此选项会将 SQL Server 对象添加到备份选定项中。有效值为 WHOLE_DATABASE、文件组的名称或文件的名称。WHOLE_DATABASE 将备份 SQL Server 实例中的所有数据库。如果添加的是文件组或文件,则所有数据库都会在包含同名文件组或文件的策略中添加该对象。使用 bpplclients 命令可配置为策略配置的实例和数据库的列表。
对于 NAS-Data-Protection 策略,可以按照以下格式指定备份选择:
nfs:<array>StorageArrayIPAddress</array><nas_head>Filer_or_NAS_Server </nas_head><nas_share./volume_name</nas_share>"
示例:
NetApp:nfs:<array>10.0.0.1</array><nas_head>ExampleNAS</nas_head><nas_share> /nas_share_01</nas_share> Nutanix AFS:nfs:<array>Example.company.com</array><nas_head>EXAMPLE_AFS</nas_head> <nas_share>/afs_share_01</nas_share>
- -add -f filename
将 filename 中列出的所有文件添加到策略文件列表中。
- -addtoquery query_string...
将指定的查询字符串添加到策略查询规则的末尾,或者如果不存在任何查询,则创建一个查询。引号 (") 必须通过反斜杠 (\) 进行转义。
有关更多详细信息和示例,请参考《适用于 VMware 的 NetBackup 指南》。
- -addtoquery -f filename
将指定文件中的条目添加到查询规则中,或者如果不存在任何查询,则创建一个查询。在该文件中,引号 (") 无需转义。
有关更多详细信息和示例,请参考《适用于 VMware 的 NetBackup 指南》。
- -delete pathname ...
从策略文件列表中删除指定路径名、文件名、脚本或指令。有关路径名列表的语法,请参考 -add。即使从策略文件列表中删除了某一项,仍然可以恢复该项的所有备份或存档。该选项必须是命令行中的最后一个条目。
- -delete -f filename
将 filename 中的指定文件从策略文件列表中删除。
- -deletefromquery query_string...
从策略查询规则中删除指定的查询字符串。
有关更多详细信息和示例,请参考《适用于 VMware 的 NetBackup 指南》。
- -deletefromquery -f filename
从查询规则中删除文件条目。
有关更多详细信息和示例,请参考《适用于 VMware 的 NetBackup 指南》。
- -exclude_volumes
在执行策略时,不会备份指定的卷。目前,仅适用于 NAS-Data-Protection 策略。
- -generation generation
确保命令作用于特定的某一代或某一版本的策略。策略每保存一次,代值就递增一次。使用 bpplinfo 或 bppllist 可列出当前代值。如果未指示任何代值,则此命令将作用于当前版本。
- -L
以长格式显示策略文件列表的内容。
- -l
以简明格式显示策略文件列表的内容。
注意:
-l 和 -L 显示的内容相似。
- -modify {old_path_name new_path_name}
修改策略文件列表中的条目。这些值是路径名对列表,形式为 {old_path_name new_path_name}。对于每个路径名对,new_name_path 在策略文件列表中取代 old_name_path。如果没有与 old_path_name 匹配的列表条目,则不会将 new_path_name 输入到策略文件列表中。有关路径名语法,请参考 -add 选项。在路径名对内部以及路径名对之间,使用空格分隔列表条目。该选项必须是命令行中的最后一个条目。
- -M master_server,...
主服务器的列表。这是一个以逗号分隔的主机名列表。如果包含该选项,将在该列表中的每一台主服务器上运行该命令。主服务器必须允许发出该命令的系统对其进行访问。如果任何主服务器发生错误,将在列表中的该主服务器位置处停止处理。默认为输入该命令的系统的主服务器。
- policy_name
指定要为其设置策略文件列表的策略。
- -reason "string"
指示您选择此命令操作的原因。您输入的原因文本字符串将被捕获并显示在审核报告中。用双引号 ("...") 将此字符串括起来。该字符串不能超过 512 个字符。该字符串不能以短划线字符 (-) 开头,也不能包含单引号 (')。
- -v
为日志记录选择详细模式。仅在调试日志功能时处于启用状态(即定义了以下目录)的情况下运行该选项才有意义:
UNIX 系统:
/usr/openv/netbackup/logs/admin
Windows 系统:
install_path\NetBackup\logs\admin
示例
示例 1 - 在另一台主服务器 kiwi 上运行备份时,显示主服务器 plim 上策略 oprdoc_policy 的策略文件列表:
# bpplinclude oprdoc_policy -L -M plim
Include: /oprdoc (UNIX systems)
Include: c:\oprdoc (Windows systems)
示例 2 - 添加和删除包括一个通配符条目的路径名,以说明 bpplinclude 对通配符的解释:
UNIX 系统:
# bpplinclude mkbpolicy -add /yap /y* # bpplinclude mkbpolicy -L Include: yap Include: /y* # bpplinclude mkbpolicy -delete /y* # bpplinclude mkbpolicy -L Include: /yap
Windows 系统:
# bpplinclude mkbpolicy -add C:\yap C:\y* # bpplinclude mkbpolicy -L Include: C:\yap Include: C:\y*/y* # bpplinclude mkbpolicy -delete C:\y* # bpplinclude mkbpolicy -L Include: C:\yap
注意:
bpplinclude 不会将 -delete 的通配符条目 y* 解释为 yap 和 y* 都应该删除。而只是将 y* 从 mkbpolicy 的包括列表中删除。在实际备份期间,当 NetBackup 选择要备份的文件时,便会解释通配符。
示例 3 - 将下面两个条目添加到某个策略的策略文件列表中,然后修改它们:
UNIX 系统:
# bpplinclude mkbpolicy -add "/ima file" "/ura file" # bpplinclude mkbpolicy -L Include: /ima file Include: /ura file bpplinclude mkbpolicy -modify "/ima file" "/ima file 2" "/ura file" "/ura file 2" bpplinclude mkbpolicy -L Include: /ima file 2 Include: /ura file 2
Windows 系统:
# bpplinclude mkbpolicy -add "C:\ima file" "C:\ura file" # bpplinclude mkbpolicy -L Include: C:\ima file Include: C:\ura file # bpplinclude mkbpolicy -modify "C:\ima file" "C:\ima file 2" "C:\ura file" "C:\ura file 2" # bpplinclude mkbpolicy -L Include: C:\ima file 2 Include: C:\ura file 2
示例 4 - 将原始分区添加到策略 rc
(UNIX 客户端)的策略文件列表中。使用设备的完整路径名(命令全部位于一行):
bpplinclude rc -add /devices/sbus@2,0/dma@2,81000/esp@2,80000/ sd@6,0:h,raw
有关 UNIX 原始分区的更多信息,请参见《NetBackup 管理指南,第 I 卷》。
示例 5 - 显示策略 mkb_policy 的策略文件列表:
# bpplinclude mkb_policy -l
UNIX 系统:
INCLUDE /etc/services INCLUDE /etc/aliases INCLUDE /usr/bin
Windows 系统:
INCLUDE C:\services INCLUDE C:\aliases INCLUDE C:\Programs
示例 6 - 将 vm17
添加到 policy1 的查询规则中的值列表中。
# bpplinclude policy1 -addtoquery ,\"vm17\"
示例 7 - 从策略中删除查询。
# bpplinclude policy1 -deletefromquery -f qfile1
示例 8 - 将 SQL Server 文件组添加到策略文件列表中。
# bpplinclude sql_policy -add FG1
文件
UNIX 系统:
/usr/openv/netbackup/logs/admin/* /usr/openv/netbackup/db/policy/policy_name/includes
Windows 系统:
install_path\NetBackup\logs\admin\* install_path\NetBackup\dv\policy\policy_name\includes