Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
bpplschedrep — 修改 NetBackup 日程表属性
大纲
policy_name sched_label [ -M master_server,...] [-v] [-generation generation] [-st sched_type] [-freq backup_frequency] [-mpxmax mpx_factor] [-cal 0|1|2] [-incl mm/dd/yyyy] [-excl mm/dd/yyyy] [-delincl mm/dd/yyyy] [-delexcl mm/dd/yyyy] [-weekday day_name week [day_name week]...] [-dayomonth 1-31 [1-31]... | l] [-xweekday day_name week [day_name week]...] [-xdayomonth 1-31 [1-31]... | l] [-deldayomonth 1-31 [1-31]... | l] [-delweekday day_name week [day_name week]...] [-ci] [-ce] [-cw] [-cd] [-number_copies number][-rl retention_level[,rl-copy2,...]] [-fail_on_error 0|1[,0|1,...,0|1]] [-residence storage_unit_label [,stunit_copy2,...]] [-pool volume_pool_label [,pool_copy2,...]] [-sg share_group [,share_copy2,...]] [-(0..6) start duration] [-res_is_stl 0 | 1] [-reason "string"] [-slpwindow] [-checksum_change_detection 0|1]
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
bpplschedrep 可更改已定义策略的 NetBackup 日程表的属性。在运行 bpplschedrep 时,该命令指定的日程表和策略应该已经存在。如果使用了 -M 选项,bpplschedrep 将更改列出的每台主服务器上的日程表。
通过 -slpwindow 选项,您可以为基于时段且仅支持开始时间和结束时间的存储生命周期策略 (SLP) 设置日程表。您必须使用预定义的策略名称 SLP_Internal_Policy,且日程表类型必须为 UBAK(用户备份)。
任何得到授权的用户均可启动此命令。
有关 NetBackup 授权的详细信息,请参见《NetBackup 安全和加密指南》。
注意:
不建议用户修改或删除自动管理的策略。
如果用户修改策略,则必须确保策略继续满足保护计划定义的服务级别目标。
如果用户删除策略,则必须确保将资产添加到满足服务级别目标的其他保护计划。
选项
- -(0..6) start duration
指定 NetBackup 可以为该日程表运行备份的时段。此时段应用于一周内特定的一天。0 对应于星期日,1 对应于星期一,依此类推。
start 是为该日程表打开备份时段的时间。此时间是从午夜 12 点开始算起的秒数。它是 0 到 86400(一天中的秒数)之间的一个整数。
duration 是时段保持有效的时间长度。时间单位是秒。此单位是一个非负整数。
- -cal 0|1|2
指示 bpplschedrep 是遵循基于日历的日程表,还是遵循基于频率的日程表。
0 = 基于频率的日程表
1 = 基于日历的日程表,在运行日后不再重试
2 = 基于日历的日程表,在运行日后重试
- -checksum_change_detection 0|1
在策略日程表中启用或禁用“加速器强制重新扫描”。
0 = 禁用
1 = 启用
- -dayomonth 1-31 [1-31]... | l
指定每月运行日程表的日期。如果输入 l(小写的 L),则在每月的最后一天运行,无论那个月有 28 天、29 天、30 天还是 31 天。
例如,如果要在每月的第 14 天和第 28 天运行策略备份,请输入以下内容:
-dayomonth 14 28
要在每月的最后一天运行,请输入:
-dayomonth l
- -deldayomonth 1-31 [1-31]... | l
指定每月的某一天不作为运行日期。如果输入 1(小写的 L),则排除每月的最后一天,无论那个月有 28 天、29 天、30 天还是 31 天。此命令只能删除使用 -dayomonth 命令添加的日期。
例如,要将您原本指定为运行日期的每月的第 20 天和第 21 天从日程表中排除,请输入:
-deldayomonth 20 21
- -delweekday day_name week [day_name week]...
指定从日程表中排除每周的某一天及每月的某一周,使其不作为运行日期。此命令只能删除使用 -weekday 命令添加的日期。
day_name 是:星期日、星期一、星期二、星期三、星期四、星期五或星期六。
week 是指该月的第几周。一周从星期日开始,到星期六结束。有效值为 1-5。
例如,要删除您原本指定为运行日期的该月的第二个星期一,请输入:
-delweekday Monday 2
- -excl mm/dd/yyyy
表示排除这一日期。
- -delincl mm/dd/yyyy
表示删除这一日期。此命令只能删除使用 -incl 命令添加的日期。
- -delexcl mm/dd/yyyy
表示删除这一日期。
- -ci
清除所有特定的包括日期。
- -ce
清除所有特定的排除日期。
- -cw
清除一周中的每一天。
- -cd
清除一个月中的每一天。
- -fail_on_error 0|1[,0|1,...,0|1]
指定如果一个副本失败,是否使所有其他副本均失败。如果没有指定参数,则所有副本的默认值为 0。为每个副本指定一个值。
0 - 不停用其他副本
1 - 停用其他副本
- -freq backup_frequency
备份频率控制在该日程表中客户端的两次成功自动备份之间的时间间隔。频率不适用于用户日程表,原因是只要备份时段有效,用户即可随时执行备份或存档。该值是一个正整数,表示该日程表的两次成功自动备份之间的秒数。
- -help
当 -help 为命令行中的唯一选项时,将输出命令行用法消息。
- -generation generation
确保命令作用于特定的某一代或某一版本的策略。策略每保存一次,代值就递增一次。使用 bpplinfo 或 bppllist 可列出当前代值。如果未指示任何代值,则此命令将作用于当前版本。
- -incl mm/dd/yyyy
表示包括这一日期。
- -M master_server,...
备用主服务器的列表。这是一个以逗号分隔的主机名列表。如果包含该选项,则列表中的每台主服务器都会运行 bpplschedrep 命令。列表中的每台主服务器必须允许发出 bpplschedrep 命令的系统对其进行访问。如果任何主服务器发生错误,将在该位置处终止处理。
将修改该列表中所有主服务器的日程表属性。
- -mpxmax mpx_factor
此日程表的最大多路复用因子。多路复用操作从一个或几个客户端向单个驱动器发送多个并行备份。
对于 NetBackup 服务器,多路复用因子的范围是从 1 到 8;对于 NetBackup Enterprise Server,范围是从 1 到 32。值 1 指定无多路复用,大于 1 的值表示 NetBackup 应该在目标介质上创建多路复用映像。此多路复用因子应该小于或等于存储单元的多路复用因子。
有关多路复用的更多信息,请参见《NetBackup 管理指南,第 I 卷》。
- -number_copies number
指定同时备份副本的数目。有效值范围是 1-4。默认值为 1。
- policy_name
包含该日程表的策略的名称。先前已创建了此策略。
- -pool volume_pool_label [,pool-copy2,...]
指定日程表的卷池。如果磁盘存储单元是该日程表的驻留位置,则不要使用该选项。如果指定了 *NULL*,则日程表的卷池是包含该日程表的策略的卷池。
为每个副本指定一个池。
要显示配置的卷池,请运行以下命令:
UNIX 系统:
/usr/openv/volmgr/bin/vmpool -listall
Windows 系统:
install_path\Volmgr\bin\vmpool -listall
- -reason "string"
指示您选择此命令操作的原因。您输入的原因文本字符串将被捕获并显示在审核报告中。用双引号 ("...") 将此字符串括起来。该字符串不能超过 512 个字符。该字符串不能以短划线字符 (-) 开头,也不能包含单引号 (')。
- -res_is_stl 0 | 1
仅当存储单元的名称和存储生命周期策略的名称相同时才指定此标志。在其他所有情况下,将忽略此标志。可能值如下所述:
0 - 驻留位置为非存储生命周期策略
1 - 驻留位置为存储生命周期策略
- -residence storage_unit_label[,stunit-copy2,...]
指定存储单元的标签,该存储单元用来存储按照该日程表创建的备份。如果指定了 *NULL*,日程表的驻留位置默认为包含该日程表的策略的驻留位置。如果驻留位置的值是某个存储单元标签,该日程表的驻留位置将变为该存储单元,并覆盖策略的驻留位置。
为每个副本指定一个存储单元。
运行 bpstulist 可显示一组已定义的存储单元。
- -rl retention_level[,rl-copy2,...]
指定 NetBackup 保留使用该日程表创建的备份的时间长度。本说明后面的内容将列出有效的保留级别及其对应的默认保留时间。
为每个副本指定一个保留级别。
小心:
使用 NetBackup 管理界面可以更改与每个级别关联的保留期限。因此,对于各个级别,您的配置可能不同于此处所显示的值。在使用此命令进行任何更改之前,请使用 NetBackup 管理界面来确定实际的保留期限。
否则,备份可能在预期的期限之前失效,从而导致数据丢失。
0(一周)
1(2 周)
2(3 周)
3(1 个月)
4(2 个月)
5(3 个月)
6(6 个月)
7(9 个月)
8(1 年)
9-100(无限期,25 除外,其设置为立即失效)
注意:
如果在 8.0 版本之前的 NetBackup 介质服务器上运行此命令,则只能指定介于 0 到 24 之间的保留级别。
NetBackup 将有关备份的信息保留所指定的一段时间。然后删除这些信息。在删除这些信息后,备份中的文件将无法还原。当卷上的所有备份都失效后,可重新分配该卷。
- sched_label
指定要更改的日程表的名称。先前已创建了此日程表。
- -sg share_group [,share_copy2,...]
指定日程表的共享组。如果日程表位于磁盘存储单元上,请不要使用此选项。如果指定了 *NONE*,则表示写入介质服务器拥有此策略所写入的介质。如果指定了 *ANY*,EMM 将选择介质所有者。*ANY* 是默认值。否则,将由指定的共享组拥有介质。指定每个副本的共享组,以显示所配置的共享组。输入以下命令:
UNIX 系统:
/usr/openv/netbackup/bin/admincmd/nbsvrgrp -list -summary
Windows 系统:
install_path\NetBackup\bin\admincmd\nbsvrgrp -list -summary
- -slpwindow
为 SLP_internal_policy 添加或删除时段。
- -st sched_type
指定日程表执行的备份类型。日程表类型分为自动类别和用户类别。自动日程表定义 NetBackup 调度程序可为策略启动备份的时段。
用户日程表定义用户可启动备份或存档的时段。
日程表类型的值如下所示:
FULL - 完全备份
INCR - 差异增量式备份
CINC - 累积增量式备份
TLOG - 事务日志
UBAK - 用户备份
UARC - 用户存档
Pre-check - 运行 NetBackup 预安装环境检查程序。此选项只能与 Deployment 策略类型结合使用。
StagePackage - 将软件包移至客户端,但不进行安装。同时执行 precheck 操作。此选项只能与 Deployment 策略类型结合使用。
InstallPackage - 安装指定的软件包。同时执行 precheck 和 stagepackage 操作。如果已执行 stagepackage 操作,则 installpackage 命令不会再次移动软件包。此选项只能与 Deployment 策略类型结合使用。
- -weekday day_name week [day_name week]...
将某周某日和某月某周指定为日程表的运行日期。
day_name 是:星期日、星期一、星期二、星期三、星期四、星期五或星期六。
week 是指该月的第几周。一周从星期日开始,到星期六结束。有效值为 1-5。
例如,要指示策略在该月的每个星期日运行,请输入:
-weekday Sunday 1 Sunday 2 Sunday 3 Sunday 4 Sunday 5
- -v
选择详细模式。该选项可使 bpplschedrep 记录用于调试的附加信息。这些信息记录在 NetBackup 每日管理调试日志中。该选项仅在 NetBackup 启用了调试日志功能(即定义了以下目录)的情况下才有意义:
UNIX 系统:
/usr/openv/netbackup/logs/admin
Windows 系统:
install_path\NetBackup\logs\admin
- -xdayomonth 1-31 [1-31]... | l
指定要从日程表中排除的日期,使其不作为运行日期。使用 l(小写 L)表示该月的最后一天。
例如,要指示策略不在该月的第 6 天运行备份,请输入:
-xdayomonth 6
- -xweekday day_name week [day_name week]...
指定要从日程表中排除的每周的某一天和每月的某一周,使其不作为运行日期。
day_name 是:星期日、星期一、星期二、星期三、星期四、星期五或星期六。
week 是指该月的第几周。有效值为 1-5。
例如,要指示策略不在该月的第三个星期一和星期三运行,请输入:
-xweekday Monday 3 Wednesday 3
示例
示例 1 - 设置日程表的频率。
# bpplschedrep mkbpolicy incr -freq 604800
该命令将频率设置为一 (1) 周,策略 mkbpolicy 中的日程表 incr 将按该频率执行自动备份。
示例 2 - 对于每周的星期六和星期日,在晚上 10 点而不是晚上 11 点打开策略 mkbpolicy 中日程表的时段。此外,将时段的持续时间设置为两 (2) 小时,而不是一 (1) 小时。bpplschedrep 重置时段, bpplsched 列出新的日程表值。
# bpplschedrep newpolicy full -0 79200 7200 -6 79200 7200 # bpplsched newpolicy -U -label full Schedule: full Type: Full Backup Frequency: every 7 days Retention Level: 1 (2 weeks) Maximum MPX: 1 Residence: (specific storage unit not required) Volume Pool: (same as policy volume pool) Daily Windows: Sunday 22:00:00 --> Sunday 24:00:00 Monday 23:00:00 --> Monday 24:00:00 Tuesday 23:00:00 --> Tuesday 24:00:00 Wednesday 23:00:00 --> Wednesday 24:00:00 Thursday 23:00:00 --> Thursday 24:00:00 Friday 23:00:00 --> Friday 24:00:00 Saturday 22:00:00 --> Saturday 24:00:00
示例 3 - 将 SLP 日程表 dup_tape1
的打开时段更改为从上午 6 点到上午 10 点。使用预定义的策略名称 SLP_internal_policy
和 UBAK 日程表类型。此时段没有属性。
# bpplschedrep SLP_internal_policy -add dup_tape1 -window 21600 14400 -st UBAK -slpwindow
文件
UNIX 系统:
/usr/openv/netbackup/logs/admin/* /usr/openv/netbackup/db/policy/policy_name/schedule
Windows 系统:
install_path\NetBackup\logs\admin\* install_path\NetBackup\db\policy\policy_name\schedule
另请参见
请参见bpplsched(1m)。