Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
- acsd
- add_media_server_on_clients
- backupdbtrace
- backuptrace
- bmrc
- bmrconfig
- bmrepadm
- bmrprep
- bmrs
- bmrsrtadm
- bp
- bparchive
- bpbackup
- bpbackupdb
- bpcatarc
- bpcatlist
- bpcatres
- bpcatrm
- bpcd
- bpchangeprimary
- 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
- bptpcinfo
- bpup
- bpverify
- cat_convert
- cat_export
- cat_import
- configureCertsForPlugins
- configureMQ
- configurePorts
- configureWebServerCerts
- create_nbdb
- csconfig cldinstance
- csconfig cldprovider
- csconfig meter
- csconfig throttle
- csconfig reinitialize
- duplicatetrace
- importtrace
- jbpSA
- jnbSA
- ltid
- manageClientCerts
- mklogdir
- nbauditreport
- nbcatsync
- NBCC
- NBCCR
- nbcertcmd
- nbcertupdater
- nbcldutil
- nbcloudrestore
- nbcomponentupdate
- nbcplogs
- nbdb_admin
- nbdb_backup
- nbdb_move
- nbdb_ping
- nbdb_restore
- nbdb_unload
- nbdbms_start_server
- nbdbms_start_stop
- nbdc
- nbdecommission
- nbdelete
- nbdeployutil
- nbdevconfig
- nbdevquery
- nbdiscover
- nbdna
- nbemm
- nbemmcmd
- nbfindfile
- nbfirescan
- nbftadm
- nbftconfig
- nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhypervtool
- nbimageshare
- nbinstallcmd
- nbjm
- nbkmsutil
- nboraadm
- nborair
- nbpem
- nbpemreq
- nbperfchk
- nbplupgrade
- nbrb
- nbrbutil
- nbregopsc
- nbreplicate
- nbrepo
- nbrestorevm
- nbseccmd
- nbsetconfig
- nbsnapimport
- nbsnapreplicate
- nbsqladm
- nbstl
- nbstlutil
- nbstop
- nbsu
- nbsvrgrp
- resilient_clients
- restoretrace
- stopltid
- tl4d
- tl8d
- tl8cd
- tldd
- tldcd
- tlhd
- tlhcd
- tlmd
- 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
名称
vltrun — 运行 NetBackup Vault 会话
大纲
-haltdups -vjobs vault_jobid [profile | robot/vault/profile] [-preview] [-verbose | -v] [-version]
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/
在 Windows 系统中,此命令的目录路径为 install_path\NetBackup\bin\
描述
vltrun 通过发出一系列对保管库引擎的调用来驱动 NetBackup Vault 会话。会话中还可以选择包含用户提供的通知脚本的标注。
选项
- profile | robot/vault/profile
指定配置文件的名称或保管库参数文件中嵌套的机械手编号、保管库和配置文件。如果使用 profile 而不指定 robot 和 vault,则配置文件必须在保管库参数文件中是唯一的。必须指定此选项。
- -vjob vault_jobid
指定当前复制的处于活动状态的保管库作业的作业 ID。
- -haltdups
终止所有关联的、活动保管库复制作业。
- -preview
为要在保管库会话中进行保管的映像生成预览列表。结果将写入会话目录下的 preview.list 文件。
- -verbose | -v
在保管库调试日志中生成详细的会话报告。
- -version
显示 vltrun 的版本,然后退出。
用法
按以下顺序执行 vltrun 会话:
运行 vlt_start_notify 脚本。
清点介质。
为返回到机械手的保管库介质初始化介质管理器数据库。
生成要进行保管的预览映像的列表。
复制映像。
清点介质管理器数据库(第一次)。
为 NetBackup 目录库备份而分配介质。
清点介质管理器数据库(第二次)。
清点映像。
暂停介质。
运行 vlt_end_notify 脚本。
再次清点映像。
分配插槽 ID。
备份 NetBackup 目录库。
清点介质管理器数据库(第三次,也是最后一次)。
运行 vlt_ejectlist_notify 脚本。
生成弹出列表。
运行 vlt_starteject_notify 脚本。
弹出并报告。
运行 vlt_end_notify 脚本。
可以通过以下任何一种方式运行 vltrun:
直接从命令行运行。
通过 NetBackup 策略预定。在这种情况下,该策略必须包含 Vault 类型,并且该策略的文件列表必须包含 vltrun 命令。
在保管库界面或 vltadm 中,为配置文件运行 Start Session 命令。
vltrun 使用 profile|robot/vault/profile 选项来运行保管库会话。如果保管库配置中没有其他具有相同名称的配置文件,则可以使用该选项的 profile 形式。在这种情况下,使用配置文件名就足以唯一地标识配置信息。
如果多个配置文件具有相同的名称,则应使用 robot/vault/profile 形式来唯一地标识该配置。
不要在保管库会话运行时修改保管库配置。
会话启动时,它将创建一个目录,用于存放 vltrun 和保管库引擎在会话期间创建的文件。
保管库会话使用以下目录:
UNIX 系统:
/usr/openv/netbackup/vault/sessions/vault_name/sidxxx
Windows 系统:
install_path\NetBackup\vault\sessions\vault_name\sidxxx
xxx 变量是分配给该会话的唯一整数。对于每个保管库名称,将从 1 开始按顺序分配会话标识符。
如果已在保管库属性中配置了电子邮件地址,则在会话结束后,会将电子邮件发送到此地址。该电子邮件将报告会话结果。默认情况下,将电子邮件发送给 root。
vltrun 将在会话目录中生成名为 summary.log 的会话概述文件。
通过在 NetBackup 二进制文件的目录 (/usr/openv/netbackup/bin) 中安装通知脚本,可在会话的几个时刻控制保管库进程。有关通知脚本的更多信息,请参考 NetBackup Vault 管理指南。
可以在 NetBackup 活动监视器中监视 vltrun 会话的进度。
活动监视器主窗口上的“操作”字段使用以下状态显示保管库会话的进度:
正在选择映像。
正在复制映像。
正在选择介质。
目录库备份。
弹出并报告。
结束。
如果创建以下具有公共写入权限的目录,则 vltrun 将在此目录下创建每日调试日志:
UNIX 系统:
usr/openv/netbackup/logs/vault
Windows 系统:
install_path\netbackup\logs\vault
该日志称为 log.DDMMYY(其中 DDMMYY 为当前日期)。然后就可使用此文件进行故障排除。
由于并非所有写入该文件的可执行文件都是以管理员或 root 身份运行的,因此需要公共写入访问权限。
可以调整此日志文件中提供的日志记录信息的级别,方法是:通过 NetBackup 管理控制台上的“主机属性”,在主服务器属性的“日志记录”页上调整保管库的日志记录级别参数。
可以使用 vltrun -haltdups 命令来终止活动保管库复制作业。启动 -haltdups 脚本,该脚本将向主保管库作业(当前处于复制步骤阶段)发送 SIGUSR2 信号。然后将信号自动传播到所有保管库复制实例,而不等待任何当前复制作业实例完成。该步骤完成后,主保管库作业将继续其余步骤。
接收到 SIGUSR2 信号后,将显示下列终止保管库复制作业消息的作业详细信息:管理员请求了终止 (150)。
必须有管理员权限才能运行此命令。
示例
示例 1 - 保管配置文件 my_profile。
# vltrun my_profile
示例 2 - 保管机械手 0 的映像、保管库 Financials 和配置文件 Weekly。
# vltrun 0/Financials/Weekly
示例 3 - 终止 ID 为 1 的活动保管库复制作业。
# vltrun -haltdups -vjob 1
返回值
在 UNIX 系统上,保管库退出时的状态码可能会大于 255。对于这些扩展的退出状态码,返回到系统的状态为 252。实际退出状态将按如下格式写入 stderr:EXIT status = exit status。
文件
UNIX 系统:
/usr/openv/netbackup/vault /usr/openv/netbackup/bp.conf /usr/openv/netbackup/logs/bpcd/log.mmddyy /usr/openv/netbackup/logs/vault/log.mmddyy /usr/openv/netbackup/db/vault/vault.xml /usr/openv/netbackup/vault/sessions/vault_name/sidxxx /usr/openv/netbackup/vault/sessions/vault_name/sidxxx/summar y.log /usr/openv/netbackup/vault/sessions/vault_name/sidxxx/detail .log
Windows 系统:
install_path\NetBackup\vault install_path\NetBackup\bp.conf install_path\NetBackup\logs\bpbrmvlt\mmddyy.log install_path\NetBackup\logs\bpcd\mmddyy.log install_path\NetBackup\logs\vault\mmddyy.log install_path\NetBackup\db\vault\vault.xml install_path\NetBackup\vault\sessions\vault_name\sidxxxinstall_path\NetBackup\vault\sessions\vault_name\sidxxx\summ ary.log install_path\NetBackup\vault\sessions\vault_name\sidxxx\deta il.log