NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
- acsd
- backupdbtrace
- backuptrace
- bmrc
- bmrconfig
- bmrepadm
- bmrprep
- bmrs
- bmrsrtadm
- bp
- bparchive
- bpbackup
- bpbackupdb
- bpcatarc
- bpcatlist
- bpcatres
- bpcatrm
- bpcd
- bpchangeprimary
- bpcleanrestore
- bpclient
- bpclimagelist
- bpclntcmd
- bpclusterutil
- bpcompatd
- bpconfig
- bpdbjobs
- bpdbm
- bpdgclone
- bpdown
- bpduplicate
- bperror
- bpexpdate
- bpfis
- bpflist
- bpgetconfig
- bpgetdebuglog
- bpimage
- bpimagelist
- bpimmedia
- bpimport
- bpinst
- bpkeyfile
- bpkeyutil
- bplabel
- bplist
- bpmedia
- bpmedialist
- bpminlicense
- bpnbat
- bpnbaz
- bppficorr
- bpplcatdrinfo
- bpplclients
- bppldelete
- bpplinclude
- bpplinfo
- bppllist
- bpplsched
- bpplschedrep
- bpplschedwin
- bppolicynew
- bpps
- bprd
- bprecover
- bprestore
- bpretlevel
- bpschedule
- bpschedulerep
- bpsetconfig
- bpstsinfo
- bpstuadd
- bpstudel
- bpstulist
- bpsturep
- bptestbpcd
- bptestnetconn
- bpup
- bpverify
- cat_convert
- cat_export
- cat_import
- configureCerts
- configureMQ
- configureWebServerCerts
- create_nbdb
- csconfig cldinstance
- csconfig cldprovider
- csconfig meter
- csconfig reinitialize
- csconfig throttle
- duplicatetrace
- importtrace
- jbpSA
- jnbSA
- ltid
- mklogdir
- msdpcldutil
- nbauditreport
- nbcallhomeproxyconfig
- nbcatsync
- NBCC
- NBCCR
- nbcertcmd
- nbcertupdater
- nbcldutil
- nbcmdrun
- nbcomponentupdate
- nbcplogs
- nbcredkeyutil
- nbdb_admin
- nbdb_backup
- nbdb_move
- nbdb_ping
- nbdb_restore
- nbdb_unload
- nbdb2adutl
- nbdbms_start_server
- nbdbms_start_stop
- nbdc
- nbdecommission
- nbdelete
- nbdeployutil
- nbdevconfig
- nbdevquery
- nbdiscover
- nbdna
- nbemm
- nbemmcmd
- nbfindfile
- nbfirescan
- nbfp
- nbftadm
- nbftconfig
- nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhypervtool
- nbidpcmd
- nbimageshare
- nbinstallcmd
- nbjm
- nbkmiputil
- nbkmscmd
- nbkmsutil
- nboraadm
- nborair
- nbpem
- nbpemreq
- nbmariadb
- nbmlb
- nbperfchk
- nbplupgrade
- nbrb
- nbrbutil
- nbreplicate
- nbrepo
- nbrestorevm
- nbseccmd
- nbserviceusercmd
- nbsetconfig
- nbshvault
- nbsmartdiag
- nbsnapimport
- nbsnapreplicate
- nbsqladm
- nbsqlite
- nbstl
- nbstlutil
- nbstop
- nbsu
- nbsvrgrp
- netbackup_deployment_insights
- resilient_clients
- restoretrace
- stopltid
- tldd
- tldcd
- tpautoconf
- tpclean
- tpconfig
- tpext
- tpreq
- tpunmount
- verifytrace
- vltadm
- vltcontainers
- vlteject
- vltinject
- vltoffsitemedia
- vltopmenu
- vltrun
- vmadd
- vmchange
- vmcheckxxx
- vmd
- vmdelete
- vmoprcmd
- vmphyinv
- vmpool
- vmquery
- vmrule
- vmupdate
- vnetd
- vssat
- vwcp_manage
- vxlogcfg
- vxlogmgr
- vxlogview
- W2KOption
名称
bpconfig — 修改或显示 NetBackup 的全局配置属性
大纲
[-cd seconds] [-ha hours] [-kl days] [-kt days] [-ma [address]] [-sto seconds] [-mj number] [-period hours] [-prep hours] [-to seconds] [-cleanup_int hours] [-cleanup_wait minutes] [-tries times] [-wi minutes] [-pui minutes] [-v] [-M master_server,...] [-rj 0|1|2] [-ica_min_size size] [-ica_retention seconds] [-image_expiry_dependency_check 0|1]
[-L | -l | -U [-v] [-M master_server,...]]
On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/admincmd/
On Windows systems, the directory path to this command is install_path\NetBackup\bin\admincmd\
描述
bpconfig 命令可修改或显示 NetBackup 全局配置属性。这些属性影响所有策略和客户端的操作，这些属性（NetBackup 管理员的电子邮件地址除外）的默认值适用于大多数安装。
请参见《NetBackup 管理指南，第 II 卷》 中的“关于指定 NetBackup 安装的区域设置”。
有关设置属性值的含义，请参见《NetBackup 管理指南，第 I 卷》中的“NetBackup 全局属性”。
以下内容描述了 bpconfig 的两种形式：
第一种形式的 bpconfig 用于修改一个或多个 NetBackup 全局配置属性。命令行上必须至少有一个用于更改 NetBackup 全局配置属性的选项。
第二种形式的 bpconfig 用于显示 NetBackup 全局配置属性的当前设置。有关更多详细信息，请参见“显示格式”。
错误将发送到 stderr。而该命令的活动日志将发送到当天的 NetBackup 管理日志文件中。
选项
- -cd seconds
指定压缩目录库间隔的秒数。如果 seconds 为整数，则自映像创建时刻起，经过该指定的秒数后将对映像进行压缩。该值的范围是 86400 到 2147472000。默认值为 0，表示无压缩。
使用 bpimage 命令解压缩映像。
- -cleanup_int hours
指定可以不进行目录库清理的最短时间段（以小时为单位）。默认值是 12（小时）。由于在目录库备份期间无法运行清理，长时间运行目录库备份的大型全天候环境可能需要较短的清理间隔（例如 3 小时）。无论此选项的值是多少，在预定备份的会话结束时，都会自动清理映像数据库。
此选项作为“映像数据库清理间隔”出现在显示输出中（见示例）。
- -cleanup_wait minutes
指定两次映像数据库目录库清理操作之间的间隔（以分钟为单位）。默认值是 60（分钟）。如果在此清理等待间隔期间发生多个备份，则在此时间段内 NetBackup 将只启动一次清理操作。该值的范围是 0 到 720（分钟）。
- -ha hours
指定此前 hours 小时数，即用于选择 NetBackup 报告条目的时间范围的开始时间。时间范围的结束时间是当前时间。例如，如果“此前 hours 小时”为 24，并且您在上午 10:00 请求提供备份状态报告，则该报告将包括：从昨天上午 10:00 直到今天上午 10:00 期间运行的所有备份。
该值用于计算常规报告和介质报告的时间范围。常规报告包括“备份状态”、“客户端备份”、“问题”和“所有日志条目”。介质报告包括“介质列表”、“介质摘要”、“介质内容”、“介质上的映像”和“介质日志条目”。
“此前 hours 小时”是一个正整数，范围是 1 到 32767。默认值为 24（小时）。
- -ica_min_size size
指定用于智能目录库存档 (ICA) 的最小目录库 .f 文件大小，以千字节 (KB) 为单位。当该值介于 0 和 2097151 之间时，将从目录库磁盘中删除任何大于或等于该大小值的目录库 .f 文件（或 files 文件）。默认值为 1024。
注意:
此属性仅适用于使用 MSDP 或 MSDP 云存储且运行 NetBackup 10.0 及更高版本的服务器。
- -ica_retention seconds
指定智能目录库存档 (ICA) 保留期限（以秒为单位）。当该值介于 1 和 2147472000 之间时，将启用 ICA 并从目录库磁盘中删除任何超过该值的目录库 .f 文件（或 files 文件）。将此值设置为零 (0) 会禁用 ICA。NetBackup Flex Scale 环境的默认值为 2592000（30 天）。所有其他 NetBackup 环境的默认值均为 0（禁用）。
注意:
此属性仅适用于使用 MSDP 或 MSDP 云存储且运行 NetBackup 10.0 及更高版本的服务器。
- -image_expiry_dependency_check 0|1
禁用或启用映像失效依赖项检查。默认情况下，启用此选项。
0 - 禁用该选项。
1 - 启用该选项。
此选项显示在 bpconfig -U 输出中：
Image Expiry Dependency Check:(enabled)
- -kl days
保留日志的天数。此数值决定 NetBackup 主服务器保留其错误数据库和调试日志的时间。
NetBackup 可从错误数据库中导出其“备份状态”、“问题”、“所有日志条目”以及“介质日志条目”等报告。
此值限制这些报告所涵盖的时间段。该值的范围是 1 到 24855。默认值为 28 天。如果值为零 (0)，则关闭日志。
注意:
该属性对于远程介质服务器或客户端无效（远程介质服务器仅适用于 NetBackup Enterprise Server）。
- -kt days
保留实际映像还原 (True Image Restore, TIR) 数据的天数。对于那些指定要收集 TIR 信息的策略，此值将决定为其保留 TIR 信息的时间。该值的范围是 1 到 24855。默认值是一 (1) 天。如果值为零 (0)，则关闭 TIR 信息。
- -L
列表类型为长列表。有关更多信息，请参见“显示格式”部分。
- -l
列表类型为短列表。如果命令行没有列表类型选项（例如，如果输入 bpconfig，然后按回车键），则此选项为默认值。有关更多信息，请参见“显示格式”部分。
- -M master_server,...
全局配置属性所驻留的主服务器。
- -ma [address]
NetBackup 管理员的邮件地址。NetBackup 会将失败的自动备份、管理员引导的手动备份操作和自动数据库备份的通知发送到该电子邮件地址。默认值为空（没有电子邮件地址）。
如果未提供地址，将清除“管理员邮件地址”的当前设置。将不会向 NetBackup 管理员发送通知电子邮件。
- -mj number
指定每个客户端的最多作业数。这是客户端可以并行执行的最多作业数。该数值必须为正整数。该值范围是 1 到 32767。默认值为 1。
- -period hours
与配置的备份尝试次数关联的时间间隔（请参见 -tries）。此间隔是以小时为单位的时间段。在此期间，NetBackup 将按照已配置的尝试次数来尝试执行客户端/策略/日程表的组合设置所安排的备份作业。小时数必须是正整数。该值范围是 1 到 24。默认值是 12 小时。
注意:
该属性不适用于用户控制的备份和存档。
- -prep hours
指定预处理间隔。此间隔是 NetBackup 使用自动发现数据流传送模式时，客户端查询（目的是发现新路径）之间的最短时间（以小时为单位）。
默认的“预处理间隔”值是四 (4) 小时。如果更改了预处理间隔，可通过指定 -prep -1 将其改回默认值。在 bpconfig 命令行上，将自动发现操作的预处理间隔指定为 0，即可将预处理间隔设置为立即进行预处理。最长“预处理间隔”是 48 小时。
有关更多信息，请参见 NetBackup 管理指南，第 I 卷。
- -pui minutes
指定策略更新间隔，即 NetBackup 策略更新的频率。默认值是 10 分钟。该值的范围是 1 到 1440（分钟）。
- -rj 0|1|2
用于更改弹性作业的行为。
启用此设置后，介质服务器的作业进程会在主服务器的服务中断期间继续运行。主服务器会在下次服务启动期间重新建立与活动介质服务器进程的连接。默认值为 2，表示启用弹性作业。
0：关闭并终止弹性作业。
此选项会阻止新作业作为弹性作业启动。此外，如果服务中断（通常会导致弹性作业重新连接到介质服务器），则作业将会终止。
1：关闭弹性作业。
此选项会阻止新作业作为弹性作业启动。
2：打开弹性作业。
此选项允许新作业作为弹性作业启动。
- -sto seconds
多主机介质装入超时。它是以秒为单位的一段时间。在此期间，NetBackup 将等待装入和定位共享介质以及将其准备好进行备份和还原。如果另一服务器正在使用共享介质，使用该超时值可以避免等待太长时间。默认值为 0，表示没有超时（不限制等待时间）。
有关多主机驱动器的更多详细信息，请参见《NetBackup 管理指南，第 I 卷》。
- -to seconds
指定介质装入超时。它是以秒为单位的时间段。在此期间，NetBackup 将等待装入和定位所请求的介质并等其准备就绪进行备份和还原。在需要手动装入介质时（例如，当机械手介质不在机械手中或者位于场外时），使用 -to 可避免等待太长时间。
默认值为 0，表示没有超时（不限制等待时间）。如果 seconds 不为 0，则该值的范围是 1 到 32,767 秒。
- -tries times
在已配置的时间段内，备份的重试次数（请参见 -period）。对于给定的客户端、策略以及日程表组合，NetBackup 按指定的次数尝试运行备份作业。如果重复发生故障，则该选项会限制尝试备份的次数。
注意:
该属性不适用于用户控制的备份和存档。
-tries 值的范围是 1 到 32767。默认值为尝试两次。如果 -tries 和 -period 都使用默认值，NetBackup 将在 12 小时内进行两次备份尝试。
- -U
列表类型为用户列表。有关更多详细信息，请参见“显示格式”。
- -v
为日志记录选择详细模式。仅在调试日志功能处于启用状态时运行该选项才有意义。因此，必须定义以下目录：
在 UNIX 系统上：
/usr/openv/netbackup/logs/admin在 Windows 系统上：
install_path\NetBackup\logs\admin- -wi minutes
作业重试延迟。指定 NetBackup 重试作业的频率。默认值是 10 分钟。该值的范围是 1 到 1440（分钟）。
显示格式
bpconfig 使用下面的三种不同格式来显示 NetBackup 全局配置属性的当前值：
“用户”显示格式 (-U)
NetBackup 图形用户界面使用此显示格式。该选项可生成列表，每行一个全局属性。每一行都具有 global attribute descriptor: value。除了全局属性描述符更为明确之外，该列表在其他方面类似于 -L 格式。
以下是“用户”显示格式的示例：
# bpconfig -U Admin Mail Address: Job Retry Delay: 1 minutes Max Simultaneous Jobs/Client: 1 Backup Tries: 2 time(s) in 12 hour(s) Keep Error/Debug Logs: 28 days Max drives this master: 0 Keep TrueImageRecovery Info: 1 days Compress DB Files: (not enabled) Media Mount Timeout: 0 minutes (unlimited) Display Reports: 24 hours ago Preprocess Interval: 0 hours Image DB Cleanup Interval: 12 hours Image DB Cleanup Wait Time: 60 minutes Policy Update Interval: 10 minutes长格式 (-L)
如果命令行包含 -L，则显示格式为长格式。此选项生成一个列表，其中每个全局属性占一行，格式为 global attribute descriptor: value。字段如下：
以下示例显示了长格式：
# bpconfig -L Mail Admin: *NULL* Job Retry Delay: 1 minutes Max Jobs/Client: 1 Backup Tries: 2 in 12 hours Keep Logs: 28 days Max drives/master: 0 Compress DB Files: (not enabled) Media Mnt Timeout: 0 minutes (unlimited) Shared Timeout: 0 minutes(unlimited) Media Int Timeout: 0 minutes (unlimited) Display Reports: 24 hours ago Keep TIR Info: 1 days Prep Interval: 0 hours DB Clean Interval: 12 hours DB Clean Wait Time: 60 minutes Policy Update Interval:10 minutes短格式 (-l)
如果 bpconfig 命令行包含 -l 或者不包含任何列表格式选项，则显示格式为短型，将产生简要列表。对于将列表内容重新编排成自定义的报告格式的脚本或程序，该选项很有用。该列表的布局是在一行中包含所有全局属性的值。对于按时间单位表示的属性，时间单位应在属性后面并用圆括号括起。属性按以下顺序显示，并以空格分隔：
以下是短格式的示例：
# bpconfig -l *NULL* 1 12 1 2 28 0 0 0 0 1 24 1 0 2 10 60对 -l 显示格式的显示字段解释如下：
尚未设置 NetBackup 管理员电子邮件地址。
作业重试延迟为 1 分钟。
时间段是 12 小时。
每个客户端的最多并行作业数是 1 个。
每个时间段的尝试次数是 2 次。
保留日志 28 天。
该主服务器的最多驱动器数是 0。
压缩目录库间隔是 0 秒；0 表示无压缩。
介质装入超时是 0 秒；0 表示无限制。
多主机介质装入超时是 0 秒；0 表示无限制。
后处理映像的标志是 1（立即）。
显示前 24 小时以来的报告。
保留 TIR 信息一 (1) 天。
预处理间隔是零 (0) 小时。
目录库数据库清理间隔是两 (2) 小时。
目录库数据库清理等待时间是 10 分钟。
策略更新间隔是 60 分钟。
智能目录库存档保留为 259200 秒。
智能目录库存档的最小文件大小为 1024 KB。
返回值
零 (0) 退出状态表示已成功运行命令。任何非零 (0) 的退出状态都表示发生了错误。
如果启用了管理日志记录，退出状态将记录在日志目录下的每日管理日志中：
Windows: install_path\NetBackup\logs\admin
UNIX: /usr/openv/netbackup/logs/admin
它具有下列形式：
bpconfig: EXIT status = exit status
如果出错，将在显示该消息之前进行诊断。
示例
示例 1 - 在主服务器 kiwi 运行时，显示主服务器 plim 上的全局属性设置：
# bpconfig -U -M plim Admin Mail Address: ichabod@null.null.com Job Retry Delay: 10 minutes Max Simultaneous Jobs/Client: 1 Backup Tries: 1 time(s) in 8 hour(s) Keep Error/Debug Logs: 6 days Max drives this master: 0 Keep TrueImageRecovery Info: 1 days Compress DB Files: (not enabled) Media Mount Timeout: 30 minutes Display Reports: 24 hours ago Preprocess Interval: 0 hours Image DB Cleanup Interval: 12 hours Image DB Cleanup Wait Time: 60 minutes Policy Update Interval: 10 minutes
示例 2 - 将压缩目录库间隔设置为 604800 秒，以便 NetBackup 对早于七天的映像进行压缩：
# bpconfig -cd 604800 #bpconfig -U Admin Mail Address: *NULL* Job Retry Delay: 10 minutes Max Simultaneous Jobs/Client: 1 Backup Tries: 2 time(s) in 12 hour(s) Keep Error/Debug Logs: 28 days Max drives this master: 0 Keep TrueImageRecovery Info: 2 days Compress DB Files: older than 7 day(s) Media Mount Timeout: 0 minutes (unlimited) Display Reports: 24 hours ago Preprocess Interval: 0 hours Image DB Cleanup Interval: 12 hours Image DB Cleanup Wait Time: 60 minutes Policy Update Interval: 10 minutes
示例 3 - 将“介质装入超时”设置为 1800 秒。
# bpconfig -to 1800 # bpconfig -U Admin Mail Address: sasquatch@wapati.edu Job Retry Delay: 10 minutes Max Simultaneous Jobs/Client: 1 Backup Tries: 1 time(s) in 12 hour(s) Keep Error/Debug Logs: 3 days Max drives this master: 0 Keep TrueImageRecovery Info: 24 days Compress Image DB Files: (not enabled) Media Mount Timeout: 30 minutes Display Reports: 24 hours ago Preprocess Interval: 0 hours Image DB Cleanup Interval: 12 hours Policy Update Interval: 10 minutes
文件
UNIX 系统：
/usr/openv/netbackup/logs/admin/* /usr/openv/netbackup/db/config/behavior
Windows 系统：
install_path\NetBackup\db\config\behavior install_path\NetBackup\logs\admin\*