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] [-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 卷》、《NetBackup for VMware 管理指南》和《NetBackup for NDMP 管理指南》中的 Accelerator 主题。
选项
- -all_columns
显示报告或摘要的所有列。以下是对各个字段的描述:
字段 1 = 作业 ID
字段 2 = 作业类型
0 = 备份,1 = 存档,2 = 还原,3 = 验证,4 = 复制,5 = 阶段 1 或阶段 2 导入,6 = 目录库备份,7 = 保管库复制,8 = 标注磁带,9 = 清除磁带,10 = 磁带请求,11 = 清洗磁带,12 = 格式化磁带,13 = 磁带库物理清点,14 = 驱动器或磁带库的资格认定测试,15 = 目录库恢复,16 = 介质内容,17 = 映像清理,18 = LiveUpdate,20 = 复制(自动映像复制),21 = 导入(自动映像复制),22 = 从快照备份,23 = 复制(快照),24 = 导入(快照),25 = 应用程序状态捕获,26 = 索引编制,27 = 索引清理,28 = 快照,29 = SnapIndex,30 = ActivateInstantRecovery,31 = DeactivateInstantRecovery,32 = ReactivateInstantRecovery,33 = StopInstantRecovery,34 = InstantRecovery
注意:
作业类型“26=索引编制”和“27=索引清理”与 NetBackup 搜索相关,自 NetBackup 版本 7.7 起不再支持该功能。
字段 3 = 作业状态
0 = 在排队等待资源,1 = 活动,2 = 在重新排队等待资源,3 = 结束,4 = 已暂停,5 = 未完成
字段 4 = 作业状态码
字段 5 = 作业的策略名称
字段 6 = 作业日程表名称
字段 7 = 客户端名称
字段 8 = 作业使用的介质服务器
字段 9 = 作业开始时间
字段 10 = 作业运行时间
字段 11 = 作业结束时间
字段 12 = 作业使用的存储单元
字段 13 = 尝试次数
字段 14 = 操作
0 = 磁带装入,1 = 磁带定位,2 = NetBackup 正在连接到介质服务器,3 = 写入磁带,4 = 选择映像,5 = 复制映像,6 = 选择介质,7 = 目录库备份,8 = 磁带弹出和报告,10 = 从磁带读取,11 = 复制,12 = 导入,13 = 验证,14 = 还原,15 = 目录库备份,16 = 保管库操作,17 = 标注磁带,18 = 清除磁带,19 = 查询数据库,20 = 处理扩展盘区,21 = 组织读取器,22 = 创建快照,23 = 删除快照,24 = 恢复数据库,25 = 介质内容,26 = 请求作业资源,27 = 父作业,28 = 索引编制,29 = 复制到远程主服务器,30 = 正在运行
字段 15 = 写入的数据量(以千字节为单位)
字段 16 = 写入的文件数
字段 17 = 上次写入路径
字段 18 = 完成的百分比
字段 19 = 作业 PID
字段 20 = 启动作业的用户帐户(所有者)
字段 21 = 子类型
0 = 立即备份,1 = 预定备份,2 = 用户启动的备份或存档,3 = 磁带快速清除,4 = 磁带慢速清除,5 = 数据库备份分段
字段 22 = 策略类型
0 = 标准(UNIX 和 Linux 客户端),4 = Oracle,6 = Informix-On-BAR,7 = Sybase,8 = MS-SharePoint Portal Server,11 = DataTools-SQL-BackTrack,13 = MS- Windows,15 = MS-SQL-Server,16 = MS-Exchange-Server,17 = SAP,18 = DB2,19 = NDMP,20 = FlashBackup,25 = Lotus Notes,29 = FlashBackup-Windows,35 = NBU-Catalog,39 = Enterprise_Vault,40 = VMware,41 = Hyper-V,44 = BigData
字段 23 = 日程表类型
0 = 完全备份,1 = 增量式备份,2 = 用户备份,3 = 用户存档,4 = 累积增量式备份,5 = tlog(事务日志备份)
字段 24 = 分配给此作业的作业优先级(如策略属性中所配置)
字段 25 = 服务器组名
字段 26 = 主服务器名称
字段 27 = 保留级别
字段 28 = 保留期限
字段 29 = 压缩
0 = 已禁用,1 = 已启用
字段 30 = 要写入的估计千字节数
字段 31 = 要写入的估计文件数
字段 32 = 文件列表计数。写入的文件数。
字段 33 = 写入的以逗号分隔的文件路径列表
字段 34 = 尝试计数。作业 ID 的尝试次数
字段 35 = 尝试信息。以逗号分隔的尝试状态信息列表
trypid = 尝试 PID,trystunit = 存储单元,tryserver = 服务器,trystarted = 尝试开始纪元时间,tryelapsed = 运行时间,tryended = 尝试结束纪元时间,trystatus = 尝试状态码,trystatusdescription,trystatuscount = 下面的 trystatuslines 中以逗号分隔的字符串数,trystatuslines = 尝试状态输出,trybyteswritten = 写入的数据量(以千字节为单位),tryfileswritten = 写入的文件数
字段 36 = 父作业编号
字段 37= kbpersec - 数据传输速度(以千字节/秒为单位)
字段 38 = 副本号
字段 39 = 机械手 - 用于作业的磁带库
字段 40 = 保管库 ID
字段 41 = 保管库配置文件
字段 42 = 保管库会话
字段 43 = 要弹出的磁带的数目
字段 44 = 源存储单元
字段 45 = 源介质服务器
字段 46 = 源介质 ID
字段 47 = 目标介质 ID
字段 48 = 数据流号
字段 49 = 可暂停操作:0 = 不可暂停,1 = 可暂停
字段 50 = 可继续操作:0 = 不可继续,1 = 可继续
字段 51 = 可重新启动:0 = 不可重新启动,1 = 可重新启动
字段 52 = 数据移动类型
0 = 标准,1 = 仅 IR 磁盘,2 = IR 磁盘和存储单元,3 = 合成,4 = 磁盘分段作业,5 = 快照
字段 53 = 快照操作:0 = 不使用快照,1 = 使用快照
字段 54 = 备份 ID
字段 55 = 可终止操作:0 = 不可终止,1 = 可终止
字段 56 = 控制主机。运行此作业的活动 PID 的主机。
字段 57 = 脱离主机类型
字段 58 = 光纤传输使用情况。0 = lan,1 = ft
字段 59 = 排队原因
0 = 未知原因,1 = 介质正在使用中,2 = 驱动器正在使用中,3 = 磁带介质服务器处于不活动状态,4 = 服务器上的磁带库已关闭,5 = 已达到存储单元的作业计数上限,6 = 正在等待介质请求延迟失效,7 = 本地驱动器关闭,8 = 介质位于 NetBackup 正在使用的驱动器中,9 = 物理驱动器不可用,10 = 清洗介质不可用,11 = 驱动器扫描主机处于不活动状态,12 = 磁盘介质服务器处于不活动状态,13 = 介质服务器当前未连接到主服务器,14 = 介质服务器不是群集的活动节点,15 = 存储单元并行作业数受限制,16 = 作业历史记录指示驱动器正在使用中,17 = 磁盘卷暂时不可用,18 = 已达到并行磁盘卷读取器数上限,19 = 磁盘池不可用,20 = FT 管道正在使用中,21 = 正在卸载磁盘卷,22 = 磁盘卷正在使用中,23 = 已达到部分已满卷数上限,24 = 已达到逻辑资源限制,25 = 存储单元中的驱动器正在使用中,26 = 正在等待共享磁带驱动器扫描停止,27 = 正在等待装入磁盘卷,28 = 已存在磁带装入点,29 = 暂停操作,30 = 已达到磁盘卷的 I/O 流计数上限
字段 60 = 重复数据删除率百分比
字段 61 = 加速器优化
字段 62 = 实例数据库名称
字段 63 = 承载 NFS 共享以进行 Oracle Copilot 备份的设备
字段 64 = 传输的 Accelerator 备份数据的千字节数
此命令为每个备份作业输出一行信息。每行输出都采用以下格式列出字段值,各个值之间以逗号分隔:
jobid,jobtype,state,status,policy,schedule,client server,started,elapsed,ended,stunit,tries,operation,kbytes, files,pathlastwritten,percent,jobpid,owner,subtype,policytype, scheduletype,priority,group,masterserver,retentionlevel ,retentionperiod,compression,kbytestobewritten,filestobe written,filelistcount,[files],trycount,[trypid,trystunit, tryserver,trystarted,tryelapsed,tryended,trystatus,trys tatusdescription,trystatuscount,trystatuslines,trybytes written,tryfileswritten],parentjob,kbpersec,copy,robot, vault,profile,session,ejecttapes,srcstunit,srcserver,src media,dstmedia,stream,suspendable,resumable,restartable, datamovement,snapshot,backupid,killable,controllinghost, offhosttype,ftusage,queuereason,dedupratio, acceleratorOptimization,instancedbname,dumpHost, kbDataTransferred
下面是一个示例:
213,0,3,0,hansel-itc,f,hansel,hansel,1368467705,0000000099, 1368467804,hansel-hcart-robot-tld-0,1,,448,451,,100,122,root, 0,0,0,0,root,gamefunvm2,2,2,0,,,1,/nbbackup,1,122,hansel-hcart -robot-tld-0,hansel,1368467706,0000000098,1368467804,0,the requested operation was successfully completed,17,05/13/2013 12:55:05 - requesting resource hansel-hcart-robot-tld-0,05/13 /2013 12:55:05 - requesting resource gamefunvm2.NBU_CLIENT. MAXJOBS.hansel,05/13/2013 12:55:05 - requesting resource gamefunvm2.NBU_POLICY.MAXJOBS.hansel-itc,05/13/2013 12:55:06 - granted resource gamefunvm2.NBU_CLIENT.MAXJOBS.hansel,05/13/2013 12:55:06 - granted resource gamefunvm2.NBU_POLICY.MAXJOBS.hansel -itc,05/13/2013 12:55:06 - granted resource AP6001,05/13/2013 12:55:06 - granted resource SEAGATE.ULTRIUM06242-XXX.000,05/13/2013 12:55:06 - granted resource hansel-hcart-robot-tld-0,05/13/2013 12:55:07 - started process bpbrm (122),05/13/2013 12:55:08 - connecting,05/13/2013 12:55:08 - connected; connect time: 000:00:00,05/13/2013 12:55:11 - mounting AP6001,05/13/2013 12:56:15 - mounted; mount time: 000:01:04,05/13/2013 12:56:24 - positioning AP6001 to file 1,05/13/2013 12:56:30 - positioned; position time: 000:00:06,05/13/2013 12:56:30 - begin writing,05/13/2013 12:56:43 - end writing; write time: 000:00:13,448,451,211,14000,2,,,,,,,,, AP6001,0,,,1,0,0,hansel_1368467706,,,0,0, ,,
有关如何解释 -all_columns 输出的示例,请参考“示例 1”。
- -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 分钟之前开始的。但此选项可以避免这种转换,使管理客户端之间的时间值保持一致。
- -most_columns
该选项的行为类似于 -all_columns,但不显示文件列表或有关以前各尝试的任何信息。-most_columns 选项比 -all_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 报告应用程序)使用的报告格式。
- -vault
显示特定于保管库作业的附加列。
- -verbose
如果以下目录存在,该选项会使 bpdbjobs 将附加信息记录到此目录下的调试日志中:
在 UNIX 系统上:
/usr/openv/netbackup/logs/bpdbjobs/*
在 Windows 系统上:
install_path\NetBackup\logs\bpdbjobs\*
- -version
输出版本字符串,然后停止。将忽略任何其他开关。
示例
示例 1 - 显示示例逻辑以对 -all_columns 的输出进行解码,以得出一个作业在成功执行(而不是第一次尝试)时的备份启动时间。
字段 9 = start time(作业第一次排队的时间。)
除非想知道作业排队的时间,否则此时间价值不大。
到字段 32 为止,所有字段都是固定的。而字段 32 显示“文件列表”
字段中的条目数。
字段 32 = filelistcount (“文件列表”
中列出的文件的数目。)
将该值与字段 33 相加可确定显示尝试次数的字段:
字段 33 + filelistcount = trycount
如果只有一次尝试,则计算下列等式可确定其开始时间:
字段 33 + filelistcount
+ 4 = [first] trystarted
如果进行了两次尝试,则需要考虑状态条目。首先,要计算状态字段中的条目数:
字段 33 + filelistcount
+ 9 = trystatuscount
然后,为得到第二次尝试的开始时间,计算下列等式:
字段 33 + filelistcount
+ 9 + trystatuscount
+ 6 = [second] trystarted