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
- 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
- configurePorts
- create_nbdb
- csconfig cldinstance
- csconfig cldprovider
- csconfig meter
- csconfig throttle
- duplicatetrace
- importtrace
- jbpSA
- jnbSA
- ltid
- manageClientCerts
- mklogdir
- nbauditreport
- nbcatsync
- NBCC
- NBCCR
- nbcertcmd
- nbcertupdater
- nbcldutil
- 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
- nbexecute
- nbfindfile
- nbfirescan
- nbftadm
- nbftconfig
- nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhypervtool
- nbjm
- nbkmsutil
- nboraadm
- nborair
- nbpem
- nbpemreq
- nbperfchk
- nbplupgrade
- nbrb
- nbrbutil
- nbregopsc
- nbreplicate
- 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
- vwcp_manage
- vxlogcfg
- vxlogmgr
- vxlogview
- W2KOption
名称
vltcontainers — 在逻辑上将卷移到容器中
大纲
-run [-rn robot_number]
-run -usingbarcodes [-rn robot_number]
-run -vltcid container_id -vault vault_name -sessionid session_id
-run -vltcid container_id -f file_name [-rn robot_number] [-usingbarcodes]
-view [-vltcid container_id]
-change -vltcid container_id -rd return_date
-delete -vltcid container_id
-version
在 UNIX 系统上，此命令的目录路径为 /usr/openv/netbackup/bin/
在 Windows 系统中，此命令的目录路径为 install_path\NetBackup\bin\
描述
vltcontainers 可将从一个或多个保管库会话中弹出的介质逻辑添加到容器中。它还可以查看、设置或更改场外容器或已经位于场外保管库中的容器的返回日期。vltcontainers 还可以从 NetBackup 和介质管理器目录库中删除容器。
可以按如下方式将介质 ID 添加到容器中：
使用键盘输入容器和介质 ID。
使用键盘接口条形码读取器扫描容器 ID 和介质 ID。键盘接口读取器也称为键盘“楔接”读取器，因为它们可在计算机上的键盘和键盘端口之间建立连接（或楔接）。
使用一个输入文件，该文件包含将添加到一个容器中的所有介质的介质 ID 或等效条形码数字。要将介质添加到多个容器中，请使用键盘或键盘接口条形码读取器输入 ID。或者，再次运行 vltcontainers 命令并指定不同的容器和文件名选项。
将特定会话弹出的所有介质添加到一个容器中。要将来自一个弹出会话的介质添加到多个容器中，请使用键盘或键盘接口条形码读取器输入 ID。
NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。/usr/openv/msg/.conf 文件 (UNIX) 和 install_path\VERITAS\msg\LC.CONF 文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。
有关更多信息，请参见《NetBackup 管理指南，第 II 卷》中的“关于指定 NetBackup 安装的区域设置”主题。
从许可使用保管库的 NetBackup 主服务器运行 vltcontainers 命令。
如果以下具有公共写入权限的目录存在，则 vltcontainers 会写入其每日调试日志文件（log.DDMMYY，其中 DDMMYY 是当前日期）中：
UNIX 系统：usr/openv/netbackup/logs/vault
Windows 系统： install_path\netbackup\logs\vault
由于并非所有写入该文件的可执行文件都是以管理员或 root 用户身份运行的，因此需要公共写入权限。
选项
- -change
更改容器的默认返回日期。容器的默认返回日期是容器中最后返回的卷的日期。它需要 -vltcid container_id 选项。
- -delete
从 NetBackup 和介质管理器目录库中删除容器记录。仅当容器中不包含任何介质时，才能将其删除。
- -f file_name
指定要从中读取介质 ID 的文件。文件中列出的所有介质都会添加到 -vltcid 选项指定的容器中。该文件可以是介质 ID 的列表（每行一个 ID）。或者，该文件也可以是由条形码读取器扫描到文件中的条形码等效数字列表（每行一个条形码）。
- -rd return_date
指定容器的返回日期。
返回日期的格式取决于区域设置。
- -rn robot_number
指定机械手，该机械手用于确定 vltcontainers 命令从中获取介质信息的 EMM 服务器。如果不使用 -rn robot_number，会将主服务器视为 EMM 服务器。只有可添加到容器的介质才是 EMM 服务器上的数据库中的介质。
- -run
将介质逻辑添加到容器中。如果不指定其他选项，则必须使用键盘输入容器 ID 和介质 ID。要使用条形码读取器扫描容器和介质 ID，请指定 -usingbarcodes 选项。要添加由特定会话弹出的介质，请使用 -vault vault_name 和 -sessionid session_id 选项。要添加在文件中指定的介质，请使用 -f file_name 选项。要指定主服务器以外的 EMM 服务器，请使用 -rn robot_number 选项。
- -sessionid session_id
保管库会话 ID。指定的会话弹出的所有介质都将添加到 -vltcid 选项指定的容器中。
- -usingbarcodes
指定键盘接口条形码读取器，该读取器可扫描容器 ID 和介质 ID，或在 -f file_name 指定的文件中使用的条形码数字。键盘接口条形码读取器（又称键盘楔接条形码读取器）将键盘和计算机上的键盘端口连接起来。
- -vault vault_name
弹出介质的配置文件所属的保管库的名称。还必须指定弹出介质（以便添加到容器中）的会话 ID (-sessionid)。
- -version
显示 vltcontainers 版本，然后退出。
- -view [-vltcid container_id]
显示为所有容器指定的返回日期。使用 -vltcid container_id 选项和参数可显示特定容器的返回日期。
- -vltcid container_id
指定容器 ID。容器 ID 可以是由最多 29 个字母数字字符（不包含空格）组成的字符串。-rd return_date 选项和参数用于更改容器返回日期。
示例
示例 1 - 使用以下命令可以：
将从 0 号机械手弹出的卷添加到容器中。
使用条形码读取器扫描容器 ID 和介质 ID。
# vltcontainers -run -usingbarcodes -rn 0
示例 2 - 查看容器 ABC123 的返回日期：
# vltcontainers -view -vltcid ABC123
示例 3 - 将容器 ABC123 的返回日期更改为 2012 年 12 月 7 日：
# vltcontainers -change -vltcid ABC123 -rd 12/07/2012
示例 4 - 从 NetBackup 和介质管理器目录库中删除容器 ABC123，请使用以下命令：
# vltcontainers -delete -vltcid ABC123
示例 5 - 将保管库 MyVault_Cntr 的会话 4 弹出的所有介质添加到容器 ABC123 中，请使用以下命令：
# vltcontainers -run -vltcid ABC123 -vault MyVault_Cntr -sessionid 4
示例 6 - 将在 medialist 文件中列出且从 0 号机械手弹出的介质添加到容器 ABC123 中：
UNIX 系统：
# vltcontainers -run -vltcid ABC123 -f /home/jack/medialist -rn 0
Windows 系统：
# vltcontainers -run -vltcid ABC123 -f C:\home\jack\medialist -rn 0
示例 7 - 使用以下命令可以：
将从挂接到主服务器的机械手弹出的介质添加到容器 ABC123 中
从
medialist文件中读取该介质的条形码
UNIX systems: # vltcontainers -run -vltcid ABC123 -f /home/jack/medialist -usingbarcodes
Windows systems: # vltcontainers -run -vltcid ABC123 -f C:\home\jack\medialist -usingbarcodes
返回值
保管库退出时的状态码可能会大于 255。这样的状态码称为扩展退出状态码。在这种情况下，返回到系统的退出状态为 252，而实际退出状态将按如下格式写入 stderr：EXIT status = exit status
《NetBackup 故障排除指南》和《NetBackup 故障排除向导》中介绍了扩展的退出状态值。
文件
UNIX 系统：
/usr/openv/netbackup/vault/sessions/cntrDB /usr/openv/netbackup/db/vault/vault.xml /usr/openv/netbackup/logs/vault
Windows 系统：
install_path\NetBackup\vault\sessions\cntrDB install_path\NetBackup\db\vault\vault.xml install_path\netbackup\logs\vault