搜索 <book_title>...

NetBackup™ 命令参考指南

Last Published: 2025-10-28

Product(s): NetBackup (11.0.0.1)

介绍
附录 A. NetBackup 命令
1. acsd
2. backupdbtrace
3. backuptrace
4. bmrc
5. bmrconfig
6. bmrepadm
7. bmrprep
8. bmrs
9. bmrsrtadm
10. bp
11. bparchive
12. bpbackup
13. bpbackupdb
14. bpcatarc
15. bpcatlist
16. bpcatres
17. bpcatrm
18. bpcd
19. bpchangeprimary
20. bpcleanrestore
21. bpclient
22. bpclimagelist
23. bpclntcmd
24. bpclusterutil
25. bpcompatd
26. bpconfig
27. bpdbjobs
28. bpdbm
29. bpdgclone
30. bpdown
31. bpduplicate
32. bperror
33. bpexpdate
34. bpfis
35. bpflist
36. bpgetconfig
37. bpgetdebuglog
38. bpimage
39. bpimagelist
40. bpimmedia
41. bpimport
42. bpinst
43. bpkeyfile
44. bpkeyutil
45. bplabel
46. bplist
47. bpmedia
48. bpmedialist
49. bpminlicense
50. bpnbat
51. bpnbaz
52. bppficorr
53. bpplcatdrinfo
54. bpplclients
55. bppldelete
56. bpplinclude
57. bpplinfo
58. bppllist
59. bpplsched
60. bpplschedrep
61. bpplschedwin
62. bppolicynew
63. bpps
64. bprd
65. bprecover
66. bprestore
67. bpretlevel
68. bpschedule
69. bpschedulerep
70. bpsetconfig
71. bpstsinfo
72. bpstuadd
73. bpstudel
74. bpstulist
75. bpsturep
76. bptestbpcd
77. bptestnetconn
78. bpup
79. bpverify
80. cat_convert
81. cat_export
82. cat_import
83. configureCerts
84. configureMQ
85. configureWebServerCerts
86. create_nbdb
87. csconfig cldinstance
88. csconfig cldprovider
89. csconfig meter
90. csconfig reinitialize
91. csconfig throttle
92. duplicatetrace
93. importtrace
94. jbpSA
95. jnbSA
96. ltid
97. mklogdir
98. msdpcldutil
99. msdpimgutil
100. nbauditreport
101. nbcallhomeproxyconfig
102. nbcatsync
103. NBCC
104. NBCCR
105. nbcertcmd
106. nbcertupdater
107. nbcldutil
108. nbcmdrun
109. nbcomponentupdate
110. nbcplogs
111. nbcredkeyutil
112. nbdb_admin
113. nbdb_backup
114. nbdb_move
115. nbdb_ping
116. nbdb_restore
117. nbdb_unload
118. nbdb2adutl
119. nbdbms_start_server
120. nbdbms_start_stop
121. nbdc
122. nbdecommission
123. nbdelete
124. nbdeployutil
125. nbdevconfig
126. nbdevquery
127. nbdiscover
128. nbdna
129. nbemm
130. nbemmcmd
131. nbepicfile
132. nbfindfile
133. nbfirescan
134. nbfp
135. nbftadm
136. nbftconfig
137. nbgetconfig
138. nbhba
139. nbholdutil
140. nbhostidentity
141. nbhostmgmt
142. nbhsmcmd
143. nbhypervtool
144. nbidpcmd
145. nbimageshare
146. nbinstallcmd
147. nbjm
148. nbkmiputil
149. nbkmscmd
150. nbkmsutil
151. nblogparser
152. nbmariadb
153. nbmysql
154. nbmlb
155. nborair
156. nboracmd
157. nbpem
158. nbpemreq
159. nbmariadb
160. nbmlb
161. nbperfchk
162. nbpgsql
163. nbplupgrade
164. nbrb
165. nbrbutil
166. nbreplicate
167. nbrepo
168. nbrestorevm
169. nbseccmd
170. nbserviceusercmd
171. nbsetconfig
172. nbshvault
173. nbsmartdiag
174. nbsnapimport
175. nbsnapreplicate
176. nbsqlcmd
177. nbsqlite
178. nbstl
179. nbstlutil
180. nbstop
181. nbsu
182. nbsvrgrp
183. netbackup_deployment_insights
184. resilient_clients
185. restoretrace
186. stopltid
187. tiermover
188. tldd
189. tldcd
190. tpautoconf
191. tpclean
192. tpconfig
193. tpext
194. tpreq
195. tpunmount
196. verifytrace
197. vltadm
198. vltcontainers
199. vlteject
200. vltinject
201. vltoffsitemedia
202. vltopmenu
203. vltrun
204. vmadd
205. vmchange
206. vmcheckxxx
207. vmd
208. vmdelete
209. vmoprcmd
210. vmphyinv
211. vmpool
212. vmquery
213. vmrule
214. vmupdate
215. vnetd
216. vssat
217. vwcp_manage
218. vxlogcfg
219. vxlogmgr
220. vxlogview
221. W2KOption

名称

vltcontainers — 在逻辑上将卷移到容器中

大纲

vltcontainers -run [-rn robot_number]

vltcontainers -run -usingbarcodes [-rn robot_number]

vltcontainers -run -vltcid container_id -vault vault_name -sessionid session_id

vltcontainers -run -vltcid container_id -f file_name [-rn robot_number] [-usingbarcodes]

vltcontainers -view [-vltcid container_id]

vltcontainers -change -vltcid container_id -rd return_date

vltcontainers -delete -vltcid container_id

vltcontainers -version

On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/

On Windows systems, the directory path to this command is 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-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-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

另请参见

请参见vltoffsitemedia (1m)。

请参见vltopmenu (1m)。