Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
bpschedule — 添加、删除或列出磁盘分段作业存储单元 (DSSU) 日程表
大纲
[-v] [-M master_server,...] -add sched_label [-freq frequency] [-stage_priority number] [-altreadhost hostname] [-number_copies number] [-residence storage_unit_label [,stunit-copy2,...]] [-pool volume_pool_label [,pool-copy2,...]] [-fail_on_error 0|1[,0|1,...0|1] [-window start_duration]] [-cal 0|1|2] [-ut] [-incl mm/dd/yyyy] [-excl 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]
[-v] [-M master_server,...] -delete sched_label...
[-v] [-M master_server,...] -deleteall
[-v] [-M master_server,...] [-L | -l | -U] [-label sched_label]
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
bpschedule 命令将执行以下操作:
添加一个新的磁盘分段作业存储单元 (DSSU) 日程表。
删除一个或多个 DSSU 日程表。
删除所有 DSSU 日程表。
列出一个或所有 DSSU 日程表(默认为列出所有 DSSU 日程表)。
对于 -add 和 -delete 选项,bpschedule 在将 DSSU 日程表更改请求提交给 NetBackup 后,立即返回到系统提示符状态。要确定更改是否成功,请再次运行 bpschedule 列出更新后的日程表信息。
即使使用了 -M 选项,列表选项也只为每个日程表显示一个条目。-l 格式分几行列出每个日程表的信息。-l 不使用名称来标识属性;日程表的属性如下所示(此处没有介绍的名称是 NetBackup 内部使用的保留名称):
第 1 行:SCHED、日程表名称、类型、max_mpx、频率、保留级别、u_wind/o/d、两个内部属性、最大片段大小、日历、副本数以及“出现错误而失败”。请注意,u_wind/o/d 是为将来使用而保留的字段。-L 显示中的 u_wind 条目也将保留,以供将来使用。
第 2 行:SCHEDWIN,七对形式为 start,duration 的值,表示一周中每天时段的开始和持续时间。星期日为第一天。
第 3 行:SCHEDRES,驻留位置(每个副本一个值)。
第 4 行:SCHEDPOOL,池(每个副本一个值)。
第 5 行:SCHEDRL,保留级别(每个副本一个值)。
第 6 行:SCHEDFOE,出现错误而失败(每个副本一个值)。
如果使用了 -M 选项,则 bpschedule 将对列出的每台主服务器执行操作。例如,如果 bpschedule 添加日程表,它会将该日程表添加到为 -M 列出的每台主服务器上的策略中。如果在列表请求中使用了 -M 选项,列表将由 -M 中列出的所有主服务器返回的信息组成。如果该命令在任何一台主服务器上失败,将在该位置处停止活动。
要修改现有的 NetBackup 日程表,请使用 NetBackup 命令 bpschedulerep。
任何得到授权的用户均可启动此命令。
有关 NetBackup 授权的详细信息,请参见《NetBackup 安全和加密指南》。
选项
对于 bpschedule 的所有形式,这些选项是通用的:
- -M master_server,...
指定备用主服务器的列表。这是一个以逗号分隔的主机名列表。如果包含该选项,则列表中的每台主服务器都会运行 bpschedule 命令。列表中的每台主服务器必须允许发出 bpschedule 命令的系统对其进行访问。
如果包含该选项,将在列表中的每台主服务器上运行该命令。如果任何主服务器发生错误,将在该位置处终止处理。
如果 bpschedule 生成了列表,列表将由该列表中的所有主服务器返回的信息组成。
如果 bpschedule 添加或删除日程表,该列表中的所有主服务器都会收到此更改。
- -v
选择详细模式,在该模式下 bpschedule 记录供调试用的附加信息。这些信息记录在 NetBackup 管理调试日志中。该选项仅在 NetBackup 启用了调试日志功能(即定义了以下目录)的情况下才有意义:
UNIX 系统:
/usr/openv/netbackup/logs/admin
Windows 系统:
install_path\NetBackup\logs\admin
其余的选项取决于 bpschedule 的形式。第一种形式的 bpschedule 将日程表添加到指定的存储单元名中。以下选项适用于这种形式的 bpschedule:
- -add sched_label [suboptions]
将一个日程表添加到指定的存储单元名中。以下内容介绍了 -add 选项的子选项。它们是所添加的日程表的属性。
- -cal 0|1|2
指示 bpschedule 是遵循基于日历的日程表,还是遵循基于频率的日程表。
0 = 基于频率的日程表
1 = 基于日历的日程表,在运行日后不再重试
2 = 基于日历的日程表,在运行日后重试
- -dayomonth 1-31 [1-31]... | l
指定每月运行日程表的日期。如果输入 l(小写的 L),则在每月的最后一天运行,无论那个月有 28 天、29 天、30 天还是 31 天。
例如,如果要在每月的第 14 天和第 28 天运行策略备份,请输入以下内容:
-dayomonth 14 28
要在每月的最后一天运行,请输入:
-dayomonth l
- -excl mm/dd/yyyy
表示排除这一日期。
- -fail_on_error 0|1[,0|1,...,0|1]
指定如果一个副本失败,是否使所有其他副本均失败。如果没有指定参数,则所有副本的默认值为 0。为每个副本指定一个值。
0 = 不停用其他副本
1 = 停用其他副本
- -freq frequency
确定备份的运行频率。此选项表示根据此日程表启动的两次备份之间的秒数。此选项的有效范围为 0 到 2419200(四周内的秒数)。如果在命令行中省略该值,则默认值为 604800(一周的持续时间,以秒为单位)。
- -incl mm/dd/yyyy
表示包括这一日期。
- -number_copies number
指定同时备份副本的数目。有效值范围是 1-4。默认值为 1。
- -pool volume_pool_label [,pool-copy2,...]
卷池的名称。此选项覆盖策略级别的卷池。如果值为 *NULL*,NetBackup 将使用在策略级别指定的卷池。默认使用在策略级别指定的卷池。卷池标签不能是“无”。如果您既不在日程表级别也不在策略级别指定卷池,NetBackup 将使用 NetBackup 的默认值。
当指定的 -number_copies 大于 1 时,为每个副本指定一个池。
- -residence storage_unit_label[,stunit-copy2,...]
这是存储单元的名称,该存储单元指定备份映像的位置。如果值为 *NULL*,NetBackup 将使用在策略级别指定的存储单元。默认情况下,NetBackup 使用在策略级别指定的存储单元。如果您既不在日程表级别也不在策略级别指定存储单元,NetBackup 将使用下一个可用的存储单元。
当指定的 -number_copies 大于 1 时,将为每个副本指定一个驻留位置。
- -stage_priority number
在存储单元组中选择存储单元时所使用的顺序:
1 = 按存储单元组对话框中显示的顺序使用存储单元(默认)。
2 = 使用最近最少使用的存储单元(将轮换使用存储单元)。
3 = 使用列表中第一个未满或未关闭的存储单元。如果存储单元只是繁忙,则策略等待写入。
- -altreadhost hostname
用于读取原来由其他介质服务器写入的备份映像的服务器。
- -ut
如果 -ut 后面跟有任何日期或时间参数,系统将按 UNIX 时间(而不是标准时间格式)接受这些参数。-ut 选项主要用于 Java。
- -weekday day_name week [day_name week]...
指定将某月某周某日作为该日程表的运行日期。
day_name 是:星期日、星期一、星期二、星期三、星期四、星期五或星期六。
week 是指该月的第几周。一周从星期日开始,到星期六结束。有效值为 1-5。
例如,要指示策略在该月的每个星期日运行,请输入:
-weekday Sunday 1 Sunday 2 Sunday 3 Sunday 4 Sunday 5
- -window start_duration
指定 NetBackup 可以为该日程表运行备份的时间。一周的每一天都使用相同的时段。
start 是为该日程表打开备份时段的时间。这是从午夜 12 点开始算起的秒数。它是 0 到 86399 之间的一个整数(一天有 86400 秒)。
duration 是时段保持有效的时间长度。时间单位是秒。这是一个非负整数。
- -xdayomonth 1-31 [1-31]... | l
指定要从日程表中排除的日期,使其不作为运行日期。使用 l(小写 L)表示该月的最后一天。
例如,要指示策略不在该月的第 14 天和第 15 天运行,请输入:
-xdayomonth 14 15
- -xweekday day_name week [day_name week]...
指定要从日程表中排除的每周的某一天和每月的某一周,使其不作为运行日期。
day_name 是:星期日、星期一、星期二、星期三、星期四、星期五或星期六。
week 是指该月的第几周。
使用 l 指示该月的最后一周。该月的一周从星期日开始,到星期一结束。有效值为 1-5。
例如,要指示策略不在该月的第一个和第三个星期一运行,请输入:
-xweekday Monday 1 Monday 3
第二种形式的 bpschedule 从指定的策略中删除一个或多个日程表。以下选项适用于这种形式的 bpschedule:
- -delete sched_label
从指定的策略中删除列出的日程表。用空格分隔 sched_label 列表的元素。列表中最多可以有 25 个标签。
第三种形式的 bpschedule 从指定的策略中删除所有日程表。以下选项适用于这种形式的 bpschedule:
- -deleteall
从指定的策略中删除所有日程表。
第四种形式的 bpschedule 为指定策略中的日程表生成相关信息列表。以下选项适用于这种形式的 bpschedule:
- -l
列表类型为短列表。这是默认的列表类型。该选项生成一个包括日程表的所有属性的简明列表。每个日程表占用列表中的一行。而且大多数属性值以数值表示。对于将列表内容重新编排成自定义的报告格式的脚本或程序,该选项很有用。
- -L
列表类型为长列表。此列表包括日程表的所有属性。有些属性值是描述性的词语而不是数字。
- -label sched_label
列出指定策略中的该日程表的属性。默认为列出指定策略中的所有日程表的信息。
- -U
列表类型为用户列表。这种列表与长类型列表相似,但它的条目较少。大多数属性值是描述性的词语而不是数字。
示例
以长格式列出日程表 test 的信息。
# bpschedule -L -label test Schedule: test Type: FULL (0) Frequency: 7day(s) (604800 seconds) Retention Level: 1(2 weeks) u-wind/o/d: 0 0 Incr Type: DELTA (0) Incr Depends: (none defined) Max Frag Size: 0 MB (1048576 MB) Maximum MPX: 1 Number copies: 1 Fail on Error: 0 Residence: (specific storage unit not required) Volume Pool: (same as policy volume pool) Daily Windows: Day Open Close W-Open W-Close Sunday 000:00:00 000:00:00 Monday 000:00:00 000:00:00 Tuesday 000:00:00 000:00:00 Wednesday 000:00:00 000:00:00 Thursday 000:00:00 000:00:00 Friday 000:00:00 000:00:00 Saturday 000:00:00 000:00:00
文件
UNIX 系统:
/usr/openv/netbackup/logs/admin/* /usr/openv/netbackup/db/sched/schedule name
Windows 系统:
install_path\NetBackup\logs\admin\* install_path\NetBackup\db\sched\schedule name