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
名称
vltoffsitemedia — 列出一组介质的场外参数值，或者更改一个介质的场外参数值
大纲
-list [-W] [-vault vault_name] [-voldbhost host_name]
-change -m media_id [-voldbhost host_name] [-d media_description] [-vltname vault_name] [-vltsent date][-vltreturn date] [-vltslot slot_no] [-vltcid container_id] [-vltsession session_id]
-version
在 UNIX 系统上，此命令的目录路径为 /usr/openv/netbackup/bin/
在 Windows 系统中，此命令的目录路径为 install_path\NetBackup\bin\
描述
用户可以使用 vltoffsitemedia 命令更改给定介质的特定保管库参数。使用此命令，用户可以用单个命令更改一个或多个参数。用户可以使用该命令来查看特定 EMM 服务器或保管库的所有介质的各个保管库参数。
如果创建以下具有公共写入权限的目录，则 vltoffsitemedia 将在此目录下创建每日调试日志：
对于 UNIX：/usr/openv/netbackup/logs/vault
对于 Windows：install_path\netbackup\logs\vault
该日志称为 log.DDMMYY（其中 DDMMYY 为当前日期）。然后就可使用此文件进行故障排除。
由于以 root 身份并非可以运行所有写入该文件的可执行文件，因此需要公共写入权限。
选项
- -change
更改指定卷的属性。
- -d media_description
指定该卷的说明。
要将 NetBackup 配置为在卷返回机械手时自动清除介质描述字段，请在 EMM 中设置 VAULT_CLEAR_MEDIA_DESC 参数。
- -list
为本地 EMM 数据库中的介质列出场外参数。要将列表限制为仅包含本地 EMM 数据库的特定保管库，请在命令中包括 -vault 选项。要为特定 EMM 数据库中的介质列出场外参数，请在命令中包括 -voldbhost 选项。
- -m media_id
要更改其保管库参数的卷的介质 ID。
- -vault vault_name
指定要列出其所有介质 ID 及其特定于保管库的参数的保管库的名称。
- -version
显示 vltoffsitemedia 版本，然后退出。
- -vltcid container_id
指定存储卷的容器。container_id（一个字符串，最多包含 29 个字母数字字符，不含空格）用于指定该卷的新容器。必须指定现有的容器 ID。在为一个 EMM 服务器中的介质分配的容器中，不能包含另一个 EMM 服务器中的介质。可以使用 -m 选项来指定卷的介质 ID。
- -vltname vault_name
指定为弹出卷的机械手配置的逻辑保管库的名称。
- -vltreturn date
指定请求从保管库供应商返回介质的日期和时间。对于目录库备份卷，此日期是请求从保管库供应商返回该介质的日期。
NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。
/usr/openv/msg/.conf文件 (UNIX) 和install_path\VERITAS\msg\LC.CONF文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。有关更多信息，请参见《NetBackup 管理指南，第 II 卷》中的“关于指定 NetBackup 安装的区域设置”主题。
- -vltsent date
指定将介质发送到场外保管库的日期和时间。
NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。
/usr/openv/msg/.conf文件 (UNIX) 和install_path\VERITAS\msg\LC.CONF文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。有关更多信息，请参见《NetBackup 管理指南，第 II 卷》中的“关于指定 NetBackup 安装的区域设置”主题。
mm/dd/yyyy [hh[:mm[:ss]]]
- -vltsession session_id
指定弹出该介质的保管库会话的标识符。
- -vltslot slot_no
为该卷占用的插槽指定保管库供应商的插槽号。
- -voldbhost host_name
指定 EMM 服务器的名称。
- -W
指定介质场外参数的可分析输出格式。对于容器，输出包括容器说明的长度、容器说明和容器 ID。输出标头行是一行以空格分隔的列标签；输出数据行是以空格分隔的字段。
示例
示例 1 - 更改 ID 为 BYQ 的介质的保管库名称和保管库发送日期。
vltoffsitemedia -change -m BYQ -vltname THISTLE -vltsent 08/01/2012 12:22:00
示例 2 - 将 ID 为 000012 的介质的保管库插槽号更改为 100。
vltoffsitemedia -change -m 000012 -vltslot 100
示例 3 - 清除介质的特定于保管库的字段。
vltoffsitemedia -change -m 000012 -vltname "" -vltsession 0 -vltslot 0 -vltsent 0 -vltreturn 0
或：
vltoffsitemedia -change -m 000012 -vltname - -vltsession 0 -vltslot 0 -vltsent 00/00/00 -vltreturn 00/00/00
示例 4 - 清除卷 ABC123 的容器 ID 和介质描述。
vltoffsitemedia -change -m ABC123 -vltcid - -d ""
或：
vltoffsitemedia -change -m ABC123 -vltcid "" -d ""
vltoffsitemedia 命令使用介质管理器命令来查询或更新 EMM 数据库。
如果 vltoffsitemedia 命令失败，请在以下目录的调试日志中查看有关失败的实际介质管理器命令的详细信息。
UNIX 系统：usr/openv/netbackup/logs/vault
Windows 系统： install_path\netbackup\logs\vault
有关介质管理器命令返回的状态码的更多信息，请参见《NetBackup 状态码参考指南》。
返回值
保管库退出时的状态码可能会大于 255。这样的状态码称为扩展退出状态码。在这种情况下，返回到系统的退出状态为 252，而实际退出状态将按如下格式写入 stderr：EXIT status = exit status
《NetBackup 状态码参考指南》和 NetBackup 故障排除工具向导中介绍了扩展的退出状态值。