Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
bppolicynew — 创建、复制或重命名 NetBackup 策略
大纲
policy_name [-verbose] [-M master_server,...] [-reason "string"]
policy_name -sameas existing_policy_name [-verbose] [-M master_server,...] [-reason "string"]
existing_policy_name -renameto policy_name [-verbose] [-M master_server,...] [-reason "string"]
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
bppolicynew 对 NetBackup 策略执行以下操作之一:
使用默认的属性值来创建新策略。
使用与现有策略相同的属性来创建新策略。
重命名现有的策略。
当运行不带 -sameas 或 -renameto 选项的 bppolicynew 时,它使用默认属性值来创建新的 NetBackup 策略。如果包含 -M,则每个主服务器上用于策略定义的默认值是该主服务器的默认值。
bppolicynew 通过将新策略添加到 NetBackup 数据库中来复制策略。新策略的客户端、文件、日程表和属性与现有策略相同。bppolicynew 不创建与现有策略同名的策略副本。
如果 bppolicynew 重命名策略,映像与策略的现有关联将丢失。这表示重命名策略之前创建的映像不包括在重命名策略的映像列表中。此命令在重命名策略时不会使用与现有策略同名的名称。
bpplinfo 使用新值来替换策略属性的默认值。bpplclients、bpplinclude 和 bpplsched 定义策略的客户端、备份文件和日程表。如果策略可以运行自动备份,它必须至少有一个客户端、一个文件指定项和一个自动日程表。
bppolicynew 将它的错误消息发送到 stderr
。bppolicynew 将它的活动日志发送到当天的 NetBackup 管理日志文件中。
授权用户可启动此命令。
有关 NetBackup 授权的详细信息,请参见《NetBackup 安全和加密指南》。
有关策略的更多信息,请参见《NetBackup 管理指南,第 I 卷》。
注意:
不建议用户修改或删除自动管理的策略。
如果用户修改策略,则必须确保策略继续满足保护计划定义的服务级别目标。
如果用户删除策略,则必须确保将资产添加到满足服务级别目标的其他保护计划。
选项
- policy_name
指定 bppolicynew 创建的 NetBackup 策略的名称,或是 bppolicynew 将现有策略更改后的名称。此选项无默认值。
该策略名称必须不同于任何现有策略的名称。它由数字、字母、加号、减号、下划线和句点字符组成。不要将减号用作第一个字符,也不要在字符间留有空格。
- existing_policy_name
bppolicynew 运行时已经存在的 NetBackup 策略的名称。该选项没有默认值。
- -renameto
将现有策略的名称更改为新的策略名称。
- -sameas
通过从现有策略中复制特性来创建新策略。
- -help
输出命令行用法消息。
- -M master_server,...
指定一个以逗号分隔的主服务器主机名列表。如果包含该选项,将在该列表中的每一台主服务器上运行该命令。服务器必须允许发出该命令的系统对其进行访问。如果发生错误,将在列表中的该位置处停止处理。默认为输入该命令的系统的主服务器。
- -reason "string"
指示您选择此命令操作的原因。您输入的原因文本字符串将被捕获并显示在审核报告中。用双引号 ("...") 将此字符串括起来。该字符串不能超过 512 个字符。该字符串不能以短划线字符 (-) 开头,也不能包含单引号 (')。
- -verbose
为日志记录选择详细模式。仅当在调试日志功能处于启用状态(即定义了以下目录)的情况下运行该选项才有意义:
UNIX 系统:
/usr/openv/netbackup/logs/admin
Windows 系统:
install_path\NetBackup\logs\admin
- policy_name
指定 bppolicynew 创建的 NetBackup 策略的名称,或是 bppolicynew 将现有策略更改后的名称。此选项无默认值。
该策略名称必须不同于任何现有策略的名称。它由数字、字母、加号、减号、下划线和句点字符组成。不要将减号用作第一个字符,也不要在字符间留有空格。
- existing_policy_name
bppolicynew 运行时已经存在的 NetBackup 策略的名称。该选项没有默认值。
- -renameto
将现有策略的名称更改为新的策略名称。
- -sameas
通过从现有策略中复制特性来创建新策略。
- -help
输出命令行用法消息。
- -M master_server,...
指定一个以逗号分隔的主服务器主机名列表。如果包含该选项,将在该列表中的每一台主服务器上运行该命令。服务器必须允许发出该命令的系统对其进行访问。如果发生错误,将在列表中的该位置处停止处理。默认为输入该命令的系统的主服务器。
- -verbose
为日志记录选择详细模式。仅当在调试日志功能处于启用状态(即定义了以下目录)的情况下运行该选项才有意义:
UNIX 系统:
/usr/openv/netbackup/logs/admin
Windows 系统:
install_path\NetBackup\logs\admin
示例
请注意,在下面这些示例中,涉及“遵循 NFS 装入”的内容仅适用于 NetBackup Enterprise Server。
示例 1 - 使用主服务器 plim 上的默认属性值来创建一个策略:
# bppolicynew ishkabibble -M plim # bppllist ishkabibble -U -M plim ------------------------------------------------------------ Policy Name: ishkabibble Policy Type: Standard Active: yes Client Compress: no Follow NFS Mounts: no Cross Mount Points: no Collect TIR info: no Block Incremental: no Mult. Data Streams: no Client Encrypt: no Policy Priority: 0 Max Jobs/Policy: 99 Disaster Recovery: 0 Residence: (specific storage unit not required) Volume Pool: NetBackup Keyword: (none specified) Clients: (none defined) Include: (none defined) Schedule: (none defined)
示例 2 - 使用现有策略 mypolicy
来创建新策略 mypolicy_copy。bppllist 显示 mypolicy_copy
与 mypolicy 具有相同的属性。为简明起见,下面省略了大部分日程表信息:
# bppolicynew mypolicy_copy -sameas mypolicy # bppllist mypolicy_copy -U ------------------------------------------------------------ Policy Name: mypolicy_copy Policy Type: Standard Active: yes Client Compress: no Follow NFS Mounts: no Cross Mount Points: no Collect TIR info: no Block Incremental: no Mult. Data Streams: no Client Encrypt: no Policy Priority: 0 Max Jobs/Policy: 99 Disaster Recovery: 0 Residence: myunit Volume Pool: NetBackup Keyword: (none specified) HW/OS/Client: Linux RedHat zippity Include: /tmp/my Schedule: full Type: Full Backup Frequency: every 7 days Maximum MPX: 1 Retention Level: 0 (1 week) Residence: (specific storage unit not required) Volume Pool: (same as policy volume pool) Daily Windows: Sunday 00:00:00 --> Sunday 08:00:00 Monday 00:00:00 --> Monday 08:00:00 Tuesday 00:00:00 --> Tuesday 08:00:00 Wednesday 00:00:00 --> Wednesday 08:00:00 Thursday 00:00:00 --> Thursday 08:00:00 Friday 00:00:00 --> Friday 08:00:00 Saturday 00:00:00 --> Saturday 08:00:00 Schedule: incr Type: Differential Incremental Backup
# bppolicynew mypolicy_copy -sameas mypolicy # bppllist mypolicy -U ------------------------------------------------------------ Policy Name: mypolicy Policy Type: Standard Active: yes Client Compress: no Follow NFS Mounts: no Cross Mount Points: no Collect TIR info: no Block Incremental: no Mult. Data Streams: no Client Encrypt: no Policy Priority: 0 Max Jobs/Policy: 99 Disaster Recovery: 0 Residence: myunit Volume Pool: NetBackup Keyword: (none specified) HW/OS/Client: Linux RedHat zippity Include: /tmp/my Schedule: full Type: Full Backup Frequency: every 7 days Maximum MPX: 1 Retention Level: 0 (1 week) Residence: (specific storage unit not required) Volume Pool: (same as policy volume pool) Daily Windows: Sunday 00:00:00 --> Sunday 08:00:00 Monday 00:00:00 --> Monday 08:00:00 Tuesday 00:00:00 --> Tuesday 08:00:00 Wednesday 00:00:00 --> Wednesday 08:00:00 Thursday 00:00:00 --> Thursday 08:00:00 Friday 00:00:00 --> Friday 08:00:00 Saturday 00:00:00 --> Saturday 08:00:00 Schedule: incr Type: Differential Incremental Backup # bppllist mypolicy_copy -U ------------------------------------------------------------ Policy Name: mypolicy_copy Policy Type: Standard Active: yes Client Compress: no Follow NFS Mounts: no Cross Mount Points: no Collect TIR info: no Block Incremental: no Mult. Data Streams: no Client Encrypt: no Policy Priority: 0 Max Jobs/Policy: 99 Disaster Recovery: 0 Residence: myunit Volume Pool: NetBackup Keyword: (none specified) HW/OS/Client: Linux RedHat zippity Include: /tmp/my Schedule: full Type: Full Backup Frequency: every 7 days Maximum MPX: 1 Retention Level: 0 (1 week) Residence: (specific storage unit not required) Volume Pool: (same as policy volume pool) Daily Windows: Sunday 00:00:00 --> Sunday 08:00:00 Monday 00:00:00 --> Monday 08:00:00 Tuesday 00:00:00 --> Tuesday 08:00:00 Wednesday 00:00:00 --> Wednesday 08:00:00 Thursday 00:00:00 --> Thursday 08:00:00 Friday 00:00:00 --> Friday 08:00:00 Saturday 00:00:00 --> Saturday 08:00:00 Schedule: incr Type: Differential Incremental Backup
示例 3 - 将策略 policy_old 重命名为 policy_new。在重命名前后,bppllist 显示 NetBackup 配置数据库中的策略:
bppllist mypolicy policy_old test bppolicynew policy_old -renameto policy_new bppllist mypolicy policy_new test
返回值
零 (0) 退出状态表示已成功运行命令。
任何非零 (0) 的退出状态都表示发生了错误。
如果启用了管理日志功能,bppllist 将退出状态记录在日志目录下的每日管理日志中:
UNIX 系统:
/usr/openv/netbackup/logs/admin
Windows 系统:
install_path\NetBackup\logs\admin
它具有下列形式:
bppolicynew: EXIT status = exit status
如果出错,将在显示该消息之前进行诊断。
文件
UNIX 系统:
/usr/openv/netbackup/logs/admin/* /usr/openv/netbackup/db/policy/policy_name
Windows 系统:
install_path\NetBackup\logs\admin\* install_path\NetBackup\db\policy\policy_name