Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
bpdbjobs — 与 NetBackup 作业数据库进行交互
大纲
[-report] [-M master_servers] [-ignore_parent_jobs] [ -vault | -lvault | -all_columns | -most_columns | -gdm ] [-file pathname] [-append] [-noheader] [-mastertime] [-utc] [-t timestamp] [-jobid job1,job2,...jobn] [verbose]
-summary [-M master_servers] [-ignore_parent_jobs] [ -U | -L | -all_columns ] [-file pathname] [-append] [verbose]
-resume | -suspend | -delete | -cancel | -restart job1,job2,...jobn | type=jobtype | type=all [-M master_servers] [-quiet] [-reason "string"]
-cancel_all [-M master_servers] [-reason "string"]
-clean [-M master_servers] [ -keep_hours hours | -keep_days days ] [ -keep_successful_hours hours | -keep_successful_days days ] [verbose]
-version
-change_priority_by [-M master_servers] -priority number -jobid job1,job2,...jobn
-set_priority [-M master_servers] -priority number -jobid job1,job2,...jobn
-fast
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
bpdbjobs 可与作业数据库进行交互,在脚本中或者作为命令行管理工具都很有用。它可输出整个作业数据库、输出数据库的摘要、删除已结束作业、取消未完成作业以及清除旧作业。
要自定义 bpdbjobs 的输出,请在 bp.conf 文件中添加列定义条目 (BPDBJOBS_COLDEFS)。
有关 bp.conf
文件、完整的定义列表和 BPDBJOBS_COLDEFS 条目的更多信息,请参见 NetBackup 管理指南,第 I 卷。
-cancel、-delete、-jobid、-resume 和 -suspend 选项都将 jobtype 作为一个子选项来使用。输入以下任一类型作为 jobtype。(系统将忽略大写字母后面的字母)。
ALL | * REStore BACkup ARChive VERify DUPlicate IMPort LABel ERAse VAUlt TPReq CLEan FORmat INVentory QUAlification DBbackup | CATalogbackup
注意:
对于 NetBackup Accelerator 功能,bpdbjobs 报告通过网络为每个备份传输的数据量。您还可以将该命令配置为在通常显示 Accelerator 备份映像大小的字段中显示已传输的数据。有关详细信息,请参见《NetBackup 管理指南,第 I 卷》、《适用于 VMware 的 NetBackup 管理指南》和《适用于 NDMP 的 NetBackup 管理指南》中的“加速器”主题。
选项
- -all_columns
显示报告或摘要的所有列。此命令为每个备份作业输出一行信息。每行输出都是一个以逗号分隔的列表。输出中包含作业 ID、字段 1 和客户端名称、字段 7 等信息。
注意:
-all_columns 选项中的字段值不稳定。它们可能因版本而异。有关这些字段的任何信息如有更改,恕不另行通知。
- -append
将输出追加到由 -file 选项指定的文件。如果未提供 -file 选项,则将输出发送到 stdout。
- -cancel job1,job2,...jobn |type=jobtype|type=all
使 bpdbjobs 完全取消在活动监视器中显示且状态码为 150 的活动作业。例如:
bpdbjobs -cancel 11328 bpdbjobs -cancel 11328,11329,11330
在“描述”部分列出可能的 jobtype 值。
- -cancel_all
使 bpdbjobs 完全取消在活动监视器中显示且状态为 150 的所有未完成作业。例如:
bpdbjobs -cancel_all
- -change_priority_by [-M master_servers] -priority number -jobid job1,job2,...jobn
更改指定作业的优先级。
- -clean
使 bpdbjobs 删除指定时间段之前的已完成作业。如果该选项与 -keep_hours 或 -keep_days 参数一起使用,或者与 -keep_successful_hours 或 -keep_successful_days 参数一起使用,则可指定保留期限。例如:
bpdbjobs -clean -keep_hours 30
- -delete job1,job2,...jobn |type=jobtype|type=all
删除活动监视器中显示的已完成作业。可以在一个命令中删除多个作业 ID。例如:
bpdbjobs -delete 11328,11329,11330
此选项删除下列作业之一:
job1,job2,...jobn 指定的作业
jobtype 指定的所有符合条件的作业
指定 type=all 的情况下所有符合条件的作业
在“描述”部分列出可能的 jobtype 值。
- -fast
从 bpjobd 检索作业元数据,但是
try
文件和files
文件是直接从文件系统读取的。如果从远程主机(不是主服务器的主机)启动 bpdbjobs,则忽略此选项。- -file pathname
指出要将 bpdbjobs 的输出写入哪个文件。如果未提供 -file 选项,则将输出发送到 stdout。
- -gdm
在报告中显示的信息比 -most_columns 少。
- -ignore_parent_jobs
忽略 -report 和 -summary 选项的父作业。
- -jobid job1,job2,...jobn |type=jobtype|type=all
对多个作业 ID 进行报告。
在“描述”部分列出可能的 jobtype 值。
- -keep_days days
与 -clean 选项一起使用可指定 bpdbjobs 将已完成的作业保留多少天。默认值为三 (3) 天。
- -keep_hours hours
与 -clean 选项一起使用可指定 bpdbjobs 将已完成的作业保留多少小时。默认值为 72 小时。
- -keep_successful_days days
与 -clean 选项一起使用可指定 bpdbjobs 将已完成的作业保留多少天。默认值为三 (3) 天。
该值必须小于 -keep_days 的值。
- -keep_successful_hours hours
与 -clean 选项一起使用可指定 bpdbjobs 将已成功完成的作业保留多少小时。默认值为 72 小时。
该值必须小于 -keep_hours 的值。
- -L
长格式报告。
- -lvault
显示特定于保管库作业的附加列。
- -M master_servers
适用于有多台主服务器的环境。使用 -M 选项为特定主服务器汇总作业、删除作业 ID、取消作业 ID 和取消所有活动作业 ID:
- -mastertime
默认情况下,bpdbjobs 将开始时间或结束时间转换为相对于本地时钟的时间。因此,无论与主服务器的时区和时钟存在多少差异,一个 10 分钟之前开始的作业看上去就是从 10 分钟之前开始的。但此选项可以避免这种转换,使管理客户端之间的时间值保持一致。要规范化为 UTC 而不是使用本地时钟,请参见 -utc 选项。
- -most_columns
该选项的行为类似于 -all_columns,但不包括文件列表或有关以前各尝试的任何信息。-most_columns 选项比 -all_columns 要快得多。
注意:
-most_columns 选项中的字段值不稳定。它们可能因版本而异。有关这些字段的任何信息如有更改,恕不另行通知。
- -noheader
禁止在报告中显示标头。
- -quiet
取消报告继续、暂停、删除和取消的作业数。
- -reason "string"
指示您执行此命令操作的原因。您输入的原因文本字符串将被捕获并显示在审核报告中。该字符串必须用双引号 ("...") 引起来,并且不能超过 512 个字符。该字符串不能以短划线字符 (-) 开头,也不能包含单引号 (')。
- -report
提供存储在活动监视器中的数据的报告。如果未随 bpdbjobs 一起指定任何选项,则 -report 为默认选项。
- -restart job1,job2,...jobn |type=jobtype|type=all
干净地重新启动 jobtype 指明的作业。此选项支持备份,并且允许您在活动监视器中键入 BACkup 一词来重新启动作业。
- -resume job1,job2,...jobn |type=jobtype|type=all
恢复 job1,job2,...jobn 指定的作业,恢复所有符合条件的检查点备份或还原 jobtype 指明的作业,或者恢复所有符合条件的作业(当指定了 type=all 时)。
在“描述”部分列出可能的 jobtype 值。
- -set_priority [-M master_servers] -priority number -jobid job1,job2,...jobn
将指定作业的优先级设置为指定的优先级数字。
- -summary [-U | -L | -all_columns]
将存储在 NBU/jobs 中的所有作业的摘要行输出到 stdout。 -U 和 -L 参数可设置该命令的输出格式。使用 -file 选项,可将输出写入到给定的目录或文件名。例如:
bpdbjobs -summary -U -file /tmp/summary.out
- -suspend job1,job2,...jobn |type=jobtype|type=all
暂停 job1,job2,...jobn 指定的作业,暂停所有符合条件的检查点备份或还原 jobtype 指明的作业,或者暂停所有符合条件的作业(当指定了 type=all 时)。
在“描述”部分列出可能的 jobtype 值。
- -t timestamp
获取在指定时间戳之后修改的作业记录。按下面的格式指定时间戳:
mm/dd/yyyy hh:mm:ss
NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。
/usr/openv/msg/.conf
文件 (UNIX) 和install_path\VERITAS\msg\LC.CONF
文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。有关系统区域设置的更多信息,请参见 NetBackup 管理指南,第 II 卷中的“关于指定 NetBackup 安装的区域设置”。
- -U
用户格式的报告。这是由 NetBackup 报告生成工具(如 NetBackup-Java 报告应用程序)使用的报告格式。
- -utc
输出使用协调世界时 (UTC) 的开始时间和结束时间,而不是相对于本地时钟的开始时间和结束时间。此开关转换的时间在时间签名中使用 +0000 表示 UTC。完整示例:01/01/19 12:00:00+0000。各种报告使用原始时间戳,它们不用转换。
- -vault
显示特定于保管库作业的附加列。
- -verbose
如果以下目录存在,该选项会使 bpdbjobs 将附加信息记录到此目录下的调试日志中:
在 UNIX 系统上:
/usr/openv/netbackup/logs/bpdbjobs/*
在 Windows 系统上:
install_path\NetBackup\logs\bpdbjobs\*
- -version
输出版本字符串,然后停止。将忽略任何其他开关。