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
- nbepicfile
- nbfindfile
- nbfirescan
- nbfp
- nbftadm
- nbftconfig
- nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhsmcmd
- nbhypervtool
- nbidpcmd
- nbimageshare
- nbinstallcmd
- nbjm
- nbkmiputil
- nbkmscmd
- nbkmsutil
- nblogparser
- nbmariadb
- nbmysql
- nbmlb
- nborair
- nboracmd
- nbpem
- nbpemreq
- nbmariadb
- nbmlb
- nbperfchk
- nbpgsql
- nbplupgrade
- nbrb
- nbrbutil
- nbreplicate
- nbrepo
- nbrestorevm
- nbseccmd
- nbserviceusercmd
- nbsetconfig
- nbshvault
- nbsmartdiag
- nbsnapimport
- nbsnapreplicate
- nbsqlcmd
- nbsqlite
- nbstl
- nbstlutil
- nbstop
- nbsu
- nbsvrgrp
- netbackup_deployment_insights
- resilient_clients
- restoretrace
- stopltid
- tiermover
- 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
名称
vmquery — 查询 EMM 数据库或分配及取消分配卷
大纲
[-h EMM_server | volume_database_host, ... -h EMM_server | -h volume_database_host, ... -h volume_database_host] [-vltcid vault_container_id] [-b | -w | -W | l] -a | -m media_id | -v volume_group | -rn robot_number | -rt robot_type | -mt media_type | -p pool_number | -pn pool_name | -res robot_type robot_number robot_control_host robot_coord1 robot_coord2 | -assignbyid media_id media_type pool_number stat asg_time | -deassignbyid media_id pool_number stat
On UNIX systems, the directory path to this command is /usr/openv/volmgr/bin/
On Windows systems, the directory path to this command is install_path\Volmgr\bin\
描述
在 EMM 数据库中查询卷信息。-h、-b、-W 和 -w 选项不是必选项，但您必须选择其他（12 个）选项之一，并且只能选择一个。
可以将 -b 或 -w 选项与其他 11 个选项中的任何一个组合使用，但不能同时指定 -b 或 -w 选项。
任何得到授权的用户均可运行此命令。
有关 NetBackup 授权的更多信息，请参考 NetBackup 安全和加密指南。
选项
- -h EMM_Server | volume_database_host
此选项仅适用于 NetBackup Enterprise Server。
包含卷的相关信息的企业介质管理器数据库主机的名称。如果没有指定主机，默认情况下将使用配置的 EMM 服务器。
- -b
指定以简短输出格式显示卷信息。此选项可以与其他 11 个选项中的任何一个组合使用。
- -w
指定以宽输出格式显示卷信息。此选项包括 -b 选项不会显示的其他信息，并且可与其他 11 个选项中的任何一个组合使用。
- -a
显示所有卷。
- -m media_id
按介质 ID 查询卷。介质 ID 最多为 6 个 ASCII 字符。
- -v volume_group
按卷组查询卷。卷组是标识位于相同物理位置的一系列卷的逻辑分组。
- -rn robot_number
按机械手编号查询卷。机械手编号是卷所在的机械手的唯一逻辑标识号。
- -rt robot_type
按卷所在的机械手的类型查询卷。
NetBackup Enterprise Server 的有效机械手类型如下：
none、acs、tld。
NetBackup 服务器的有效机械手类型如下：
none、tld。
- -mt media_type
按介质类型查询卷。
NetBackup Enterprise Server 的有效介质类型如下：
dlt、dlt2、dlt3、hcart、hcart2、hcart3、dlt_clean、dlt2_clean、dlt3_clean、hcart_clean、hcart2_clean、hcart3_clean。
NetBackup 服务器的有效介质类型如下：
dlt、hcart、dlt_clean、hcart_clean。
- -p pool_number
按池号查询卷。池号是卷池的索引。可以使用 vmpool -listall 来确定给定池名称的索引。
- -pn pool_name
按池名称查询卷。
- -res robot_type robot_number robot_host rob_slot
按所在位置查询卷。
- robot_host
指定主机，该主机控制卷所在的机械手。
- rob_slot
指定卷所在的机械手（机械手坐标 1）中的插槽号。
- -assignbyid media_id media_type pool_number stat asg_time
按介质 ID、池和状态分配卷。此选项只能分配非 NetBackup 介质。非 NetBackup 介质包括以下对象使用的介质：Veritas Storage Migrator、Veritas 数据生命周期管理器或由在 NetBackup 策略框架外部工作的用户（例如，直接使用 tpreq 的用户）使用的介质。
-assignbyid 选项不能用于状态 (stat) 为 0（常规 NetBackup 磁带）或 1（NetBackup 目录库磁带）的介质。
- stat
状态只适用于为 NetBackup 或 Storage Migrator 分配的卷。可能的 stat 值有：
0 - 将卷分配给 NetBackup 常规备份。
1 - 将卷分配给 NetBackup 目录库备份。
2 - 将卷分配给 Storage Migrator。
- asg_time
此选项只适用于为 NetBackup 或 Storage Migrator 分配的卷。
指定分配卷的时间。该时间是自 1970 年 1 月 1 日 00:00:00 (UTC) 时起的秒数。asg_time 最初是使用 time() 调用创建的。
- -deassignbyid media_id pool_number stat
按介质 ID、池和状态取消分配卷。此选项仅可以取消分配非 NetBackup 介质。非 NetBackup 介质包括以下对象使用的介质：Veritas Storage Migrator、Veritas 数据生命周期管理器或由在 NetBackup 策略框架外部工作的用户（例如，直接使用 tpreq 的用户）使用的介质。要取消分配 NetBackup 磁带，请使用 bpexpdate 命令。
-deassignbyid 选项不能用于状态 (stat) 为 0（常规 NetBackup 磁带）或 1（NetBackup 目录库磁带）的介质。
- -vltcid vault_container_id
列出容器中存储的卷。vault_container_id 变量可以是最长为 29 个字母数字字符的字符串。
- -W
指定以可分析输出格式显示卷信息。
输出数据行是以空格分隔的字段，但以下情况例外：
通过在字符串末尾添加空格将介质 ID 字段填充为 6 个字符。
通过在字符串末尾添加空格将 MediaType 字段填充为 8 个字符。
MediaDescription 字段中可能包含空格。
对于保管库容器，输出中包括容器说明的长度 (DescriptionLength)、容器说明和容器 ID。输出标头行是一行以空格分隔的列标签。
说明
只完成了对选项参数的有限验证。
示例
示例 1 - 以简短格式列出主机 llama 上的 EMM 数据库中的所有卷信息：
# vmquery -h llama -b -a
示例 2 - 分配位于池 1 (NetBackup) 中的卷 A23456。该命令将状态设置为 0，并将时间指定为 08/14/23 15:50:22：
# vmquery -assignbyid A23456 hcart 1 0 1692028222
示例 3 - 取消分配位于池 2 (Storage Migrator) 中的卷 A23456，其状态为 0：
# vmquery -deassignbyid A23456 0