Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
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
在 UNIX 系统上,此命令的目录路径为 /usr/openv/volmgr/bin/
在 Windows 系统上,此命令的目录路径为 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 的有效介质类型如下:
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。
- -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,并将时间指定为 12/31/98 15:50:22:
# vmquery -assignbyid A23456 8mm 1 0 915141022
示例 3 - 取消分配位于池 2 (Storage Migrator) 中的卷 A23456,其状态为 0:
# vmquery -deassignbyid A23456 0