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
名称
vmchange — 更改 EMM 数据库中的介质信息
大纲
[-h EMM_server | volume_database_host] -vg_res -rt robot_type -rn robot_number -rh robot_control_host -v volume_group
[-h EMM_server | volume_database_host] -res -m media_id -mt media_type -rt robot_type -rn robot_number -rh robot_control_host -v volume_group -rc1 rob_slot
[-h EMM_server | volume_database_host] -exp date -m media_id
[-h EMM_server | volume_database_host] -barcode barcode -m media_id [-rt robot_type]
[-h EMM_server | volume_database_host] -m media_id -vltcid vault_container_id
[-h EMM_server | volume_database_host] -barcode barcode -vltcid vault_container_id
[-h EMM_server | volume_database_host] -d "media_description" -m media_id
[-h EMM_server | volume_database_host] -p pool_number -m media_id
[-h EMM_server | volume_database_host] -maxmounts max_mounts -m media_id
[-h EMM_server | volume_database_host] -clean cleanings left -m media_id
[-h EMM_server | volume_database_host] -n num_mounts -m media_id
[-h EMM_server | volume_database_host] -new_mt media_type -m media_id
[-h EMM_server | volume_database_host] -new_rt robot_type -m media_id -rn robot_number
[-h EMM_server | volume_database_host] -new_v volume_group [-m media_id |{-b barcode -mt media_type -rt robot_type}]
[-h EMM_server | volume_database_host] -vltname vault_name -m media_id
[-h EMM_server | volume_database_host] -vltsent date -m media_id
[-h EMM_server | volume_database_host] -vltreturn date -m media_id
[-h EMM_server | volume_database_host] -vltslot vault_slot -m media_id
[-h EMM_server | volume_database_host] -vltsession vault_session_id -m media_id
-api_eject -map map_id:mapid:...:mapid | any -w [-h EMM_server | volume_database_host] -res -ml media_id:media_id: ...:media_id -rt robot_type -rn robot_number -rh robot_control_host [-v volume_group]
-multi_eject -w [-h EMM_server | volume_database_host] -res -ml media_id:media_id: ...:media_id -rt robot_type -verbose -rn robot_number -rh robot_control_host
-multi_inject -w [-h EMM_server | volume_database_host] -res -rt robot_type -verbose -rn robot_number -rh robot_control_host
[-h EMM_server | volume_database_host] -res -robot_info -verbose -rn robot_number -rt robot_type -rh robot_control_host
在 UNIX 系统上，此命令的目录路径为 /usr/openv/volmgr/bin/
在 Windows 系统上，此命令的目录路径为 install_path\Volmgr\bin\
选项
- -h EMM_server | volume_database_host
此选项仅适用于 NetBackup Enterprise Server。
包含卷的相关信息的企业介质管理器数据库主机的名称。如果没有指定主机，默认情况下将使用配置的 EMM 服务器。
- -vg_res
更改卷组所在的位置。
- -rt robot_type
指定卷所在的机械手的类型。
NetBackup Enterprise Server 的有效机械手类型如下：
none、acs、tl4、tl8、tld、tlh、tlm
NetBackup 服务器的有效机械手类型如下：
none、tl4、tl8、tld
- -rn robot_number
卷所在的机械手的唯一逻辑标识号。
- -rh robot_control_host
主机的名称，该主机控制卷所在的机械手。
- -v volume_group
卷组是标识位于相同物理位置的一系列卷的逻辑分组。
- -res
更改卷所在的位置。
- -m media_id
指定要更改的卷的介质 ID。
- -mt media_type
指定要更改的卷的介质类型。
NetBackup Enterprise Server 的有效介质类型如下：
4mm、8mm、8mm2、8mm3、dlt、dlt2、dlt3、dtf、hcart、hcart2、hcart3、qcart、4mm_clean、8mm_clean、8mm2_clean、8mm3_clean、dlt_clean、dlt2_clean、dlt3_clean、dtf_clean、hcart_clean、hcart2_clean、hcart3_clean
NetBackup 服务器的有效介质类型如下：
4mm、8mm、dlt、hcart、qcart、4mm_clean、8mm_clean、dlt_clean、hcart_clean
- -rc1 rob_slot
机械手坐标 1 是卷所在的机械手插槽号。
以下说明仅适用于 NetBackup Enterprise Server：
不要输入 API 机械手类型的插槽信息。机械手软件将跟踪这些机械手的插槽位置。
- -exp date
该卷的截止日期。
NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。
/usr/openv/msg/.conf文件 (UNIX) 和install_path\VERITAS\msg\LC.CONF文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。有关更多信息，请参见 NetBackup 管理指南，第 II 卷中的“关于指定 NetBackup 安装的区域设置”主题。
- -barcode barcode
指定附加到卷上的条形码。
- -d "media_description"
卷的介质描述。如果描述中包含任何空格，则需要加上双引号。
- -p pool_number
包含此卷的卷池的索引。可以使用 vmpool -listall 来获取池索引。
- -maxmounts max_mounts
该卷最多可允许的装入次数。只用于非清洗介质。
- -n num_mounts
对于非清洗介质，num_mounts 是装入该卷的次数。
- -clean cleanings_left
对于清洗介质，cleanings_left 是该清洗磁带的剩余清洗次数。
- -new_mt media_type
指定要更改的卷的介质类型。有关介质类型的列表，请参见 -mt 选项。
- -new_rt robot_type
指定机械手类型。有关机械手类型的列表，请参见 -rt 选项。
- -new_v volume_group
卷组是标识位于相同物理位置的一系列卷的逻辑分组。
- -b barcode
指定附加到卷上的条形码。
- -vltcid vault_container_id
更改存储卷的容器。vault_container_id（一个字符串，最多包含 29 个字母数字字符）用于指定该卷的新容器。可以使用 -m 或 -barcode 选项来指定卷。
- -vltname vault_name
指定为弹出卷的机械手配置的逻辑保管库的名称。
- -vltsent date
指定将卷发送到场外的日期。
date 的格式取决于用户的区域设置。对于 C 区域设置，日期语法如下所示：
mm/dd/yyyy [hh[:mm[:ss]]]
- -vltreturn date
指定曾请求从保管库供应商返回卷的日期。对于目录库备份卷，这是将请求从保管库供应商返回卷的日期。
NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。
/usr/openv/msg/.conf文件 (UNIX) 和install_path\VERITAS\msg\LC.CONF文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。有关更多信息，请参见 NetBackup 管理指南，第 II 卷中的“关于指定 NetBackup 安装的区域设置”主题。
- -vltslot vault_slot
为该卷占用的插槽指定保管库供应商的插槽号。
- -vltsession vault_session_id
指定弹出该介质的保管库会话的 ID。
- -api_eject
从指定的机械手中弹出 ACS、TLH 或 TLM 卷。对于 ACS 和 TLM 机械手，弹出超时期限为一周。对于 TLH 机械手，机械手对删除介质的期限没有限制。
- -map map_id:mapid: ...:mapid | any
对于 ACS 机械手，此选项可以指定多个用于弹出操作的介质访问端口 (MAP)。map_id（也称作 CAP ID）可以是 all，也可以是 ALL，用于指定机械手中的所有 MAP。或者，它也可以是以冒号分隔的 ACS、LSM、CAP 格式的 MAP ID 列表。在使用 -map 选项时，将介质弹出到使用近似 MAP 算法指定的 MAP。该算法假定 LSM 为线性连接。
对于 TLM 机械手，使用 map_id ANY 弹出到为 DAS/SDLC 服务器上的每个介质类型配置的 MAP。
对于 TLH 机械手，选择“标准”MAP 或 BULK MAP，具体取决于库的硬件配置。
- -w
等候标志。该标志必须与弹出、多个弹出和多个弹入命令一起使用。
- -verbose
选择详细模式。
- -ml media_id:media_id: ...:media_id
指定要从机械手中弹出的介质的列表。
- -multi_eject
使用磁带库的介质访问端口来弹出多个卷。此选项仅对 TL8 和 TLD 机械手类型有效。弹出超时期限为 30 分钟。
- -multi_inject
使用磁带库的介质访问端口来弹入多个卷。此选项仅对 TL8 和 TLD 机械手类型有效。此操作完成后，用户必须运行 vmupdate 命令以更新 EMM 数据库。
- -robot_info
检索有关磁带库的信息。此选项仅对 TLD 和 TL8 机械手类型有效。
字段 1 = 插槽数
字段 2 = 邮件插槽数
字段 3 = 驱动器数
字段 4 = 机械手类型和子类型（如 tld -> 0）
字段 5 = 条形码读取器。如果此机械手设备上装有条形码读取器，此字段将包含下列字符串：This robot has a barcode reader。
字段 6 = 起始插槽
字段 7 = 结束插槽
字段 8 = 主查询字符串（如 HP~~~~~~C6240-8000~~~~~~2912）
警告
某些磁带库为其介质访问端口实现不同的功能。例如，某些库的前面板弹入和弹出功能与 NetBackup 中使用的介质访问端口 （例如 Spectra Logic Bullfrog）冲突。有些库则要求在使用介质访问端口（如 Spectra Logic Gator）时进行前面板交互。
出现以下情况时，介质将返回到（弹入到）机械手中： 使用弹出选项、未删除介质以及发生超时。如果出现此操作，应该清点机械手，然后弹出返回到机械手中的介质。
请务必阅读磁带库的操作员手册，以了解其介质访问端口功能。如果处理不当，某些库（如上述库）可能无法与 NetBackup 的弹入和弹出功能完全兼容， 而其他库可能完全不兼容。此外，NetBackup 还对这些选项参数执行有限验证。
示例
示例 1 - 更改卷 AJS100 的截止日期：
# vmchange -exp 12/31/12 23:59:59 -m AJS100
示例 2 - 将包含卷 AJS999 的池更改为池 1（NetBackup 池）：
# vmchange -p 1 -m AJS999
示例 3 - 从第 700 号 ACS 机械手中弹出卷 abc123 和 abc124。这两个卷的驻留位置将更改为独立驱动器。
# vmchange -res -api_eject -w -ml abc123:abc124 -rt acs -rn 700 -rh verbena -map 0,0,0
示例 4 - 更改卷 ABC123 的容器 ID：
# vmchange -vltcid Container001 -m ABC123