搜索 <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

名称

vltrun — 运行 NetBackup Vault 会话

大纲

vltrun -haltdups -vjobs vault_jobid [profile | robot/vault/profile] [-preview] [-verbose | -v] [-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\

描述

vltrun 通过发出一系列对保管库引擎的调用来驱动 NetBackup Vault 会话。会话中还可以选择包含用户提供的通知脚本的标注。

选项

profile | robot/vault/profile: 指定配置文件的名称或保管库参数文件中嵌套的机械手编号、保管库和配置文件。如果使用 profile 而不指定 robot 和 vault，则配置文件必须在保管库参数文件中是唯一的。必须指定此选项。
-vjob vault_jobid: 指定当前复制的处于活动状态的保管库作业的作业 ID。
-haltdups: 终止所有关联的、活动保管库复制作业。
-preview: 为要在保管库会话中进行保管的映像生成预览列表。结果将写入会话目录下的 preview.list 文件。
-verbose | -v: 在保管库调试日志中生成详细的会话报告。
-version: 显示 vltrun 的版本，然后退出。

用法

按以下顺序执行 vltrun 会话：

运行 vlt_start_notify 脚本。
清点介质。
为返回到机械手的保管库介质初始化介质管理器数据库。
生成要进行保管的预览映像的列表。
复制映像。
清点介质管理器数据库（第一次）。
为 NetBackup 目录库备份而分配介质。
清点介质管理器数据库（第二次）。
清点映像。
暂停介质。
运行 vlt_end_notify 脚本。
再次清点映像。
分配插槽 ID。
备份 NetBackup 目录库。
清点介质管理器数据库（第三次，也是最后一次）。
运行 vlt_ejectlist_notify 脚本。
生成弹出列表。
运行 vlt_starteject_notify 脚本。
弹出并报告。
运行 vlt_end_notify 脚本。

可以通过以下任何一种方式运行 vltrun：

直接从命令行运行。
通过 NetBackup 策略预定。在这种情况下，该策略必须包含 Vault 类型，并且该策略的文件列表必须包含 vltrun 命令。
在保管库界面或 vltadm 中，为配置文件运行 Start Session 命令。

vltrun 使用 profile|robot/vault/profile 选项来运行保管库会话。如果保管库配置中没有其他具有相同名称的配置文件，则可以使用该选项的 profile 形式。在这种情况下，使用配置文件名就足以唯一地标识配置信息。

如果多个配置文件具有相同的名称，则应使用 robot/vault/profile 形式来唯一地标识该配置。

不要在保管库会话运行时修改保管库配置。

会话启动时，它将创建一个目录，用于存放 vltrun 和保管库引擎在会话期间创建的文件。

保管库会话使用以下目录：

UNIX 系统：

/usr/openv/netbackup/vault/sessions/vault_name/sidxxx

Windows 系统：

install_path\NetBackup\vault\sessions\vault_name\sidxxx

xxx 变量是分配给该会话的唯一整数。对于每个保管库名称，将从 1 开始按顺序分配会话标识符。

如果已在保管库属性中配置了电子邮件地址，则在会话结束后，会将电子邮件发送到此地址。该电子邮件将报告会话结果。默认情况下，将电子邮件发送给 root。

vltrun 将在会话目录中生成名为 summary.log 的会话概述文件。

通过在 NetBackup 二进制文件的目录 (/usr/openv/netbackup/bin) 中安装通知脚本，可在会话的几个时刻控制保管库进程。有关通知脚本的更多信息，请参考 NetBackup Vault 管理指南。

可以在 NetBackup 活动监视器中监视 vltrun 会话的进度。

活动监视器主窗口上的“操作”字段使用以下状态显示保管库会话的进度：

正在选择映像。
正在复制映像。
正在选择介质。
目录库备份。
弹出并报告。
结束。

如果创建以下具有公共写入权限的目录，则 vltrun 将在此目录下创建每日调试日志：

UNIX 系统：

usr/openv/netbackup/logs/vault

Windows 系统：

install_path\netbackup\logs\vault

该日志称为 log.DDMMYY（其中 DDMMYY 为当前日期）。然后就可使用此文件进行故障排除。

由于并非所有写入该文件的可执行文件都是以管理员或 root 身份运行的，因此需要公共写入访问权限。

可以调整此日志文件中提供的日志记录信息的级别，方法是：通过 NetBackup 管理控制台上的“主机属性”，在主服务器属性的“日志记录”页上调整保管库的日志记录级别参数。

可以使用 vltrun -haltdups 命令来终止活动保管库复制作业。启动 -haltdups 脚本，该脚本将向主保管库作业（当前处于复制步骤阶段）发送 SIGUSR2 信号。然后将信号自动传播到所有保管库复制实例，而不等待任何当前复制作业实例完成。该步骤完成后，主保管库作业将继续其余步骤。

接收到 SIGUSR2 信号后，将显示下列终止保管库复制作业消息的作业详细信息：管理员请求了终止 (150)。

必须有管理员权限才能运行此命令。

示例

示例 1 - 保管配置文件 my_profile。

# vltrun my_profile

示例 2 - 保管机械手 0 的映像、保管库 Financials 和配置文件 Weekly。

# vltrun 0/Financials/Weekly

示例 3 - 终止 ID 为 1 的活动保管库复制作业。

# vltrun -haltdups -vjob 1

返回值

在 UNIX 系统上，保管库退出时的状态码可能会大于 255。对于这些扩展的退出状态码，返回到系统的状态为 252。实际退出状态将按如下格式写入 stderr：EXIT status = exit status。

文件

UNIX 系统：

/usr/openv/netbackup/vault
/usr/openv/netbackup/bp.conf
/usr/openv/netbackup/logs/bpcd/log.mmddyy
/usr/openv/netbackup/logs/vault/log.mmddyy
/usr/openv/netbackup/db/vault/vault.xml
/usr/openv/netbackup/vault/sessions/vault_name/sidxxx
/usr/openv/netbackup/vault/sessions/vault_name/sidxxx/summar
y.log
/usr/openv/netbackup/vault/sessions/vault_name/sidxxx/detail
.log

Windows 系统：

install_path\NetBackup\vault
install_path\NetBackup\bp.conf
install_path\NetBackup\logs\bpbrmvlt\mmddyy.log
install_path\NetBackup\logs\bpcd\mmddyy.log
install_path\NetBackup\logs\vault\mmddyy.log
install_path\NetBackup\db\vault\vault.xml
install_path\NetBackup\vault\sessions\vault_name\sidxxx
install_path\NetBackup\vault\sessions\vault_name\sidxxx\summ
ary.log
install_path\NetBackup\vault\sessions\vault_name\sidxxx\deta
il.log

另请参见

请参见vltadm (1m)。

请参见vlteject (1m)。

请参见vltinject (1m)。

请参见vltoffsitemedia (1m)。

请参见vltopmenu (1m)。