Search <book_title>...

NetBackup™ 命令参考指南

Last Published: 2023-12-28

Product(s): NetBackup (10.3)

介绍
附录 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. nbauditreport
100. nbcallhomeproxyconfig
101. nbcatsync
102. NBCC
103. NBCCR
104. nbcertcmd
105. nbcertupdater
106. nbcldutil
107. nbcmdrun
108. nbcomponentupdate
109. nbcplogs
110. nbcredkeyutil
111. nbdb_admin
112. nbdb_backup
113. nbdb_move
114. nbdb_ping
115. nbdb_restore
116. nbdb_unload
117. nbdb2adutl
118. nbdbms_start_server
119. nbdbms_start_stop
120. nbdc
121. nbdecommission
122. nbdelete
123. nbdeployutil
124. nbdevconfig
125. nbdevquery
126. nbdiscover
127. nbdna
128. nbemm
129. nbemmcmd
130. nbfindfile
131. nbfirescan
132. nbfp
133. nbftadm
134. nbftconfig
135. nbgetconfig
136. nbhba
137. nbholdutil
138. nbhostidentity
139. nbhostmgmt
140. nbhypervtool
141. nbidpcmd
142. nbimageshare
143. nbinstallcmd
144. nbjm
145. nbkmiputil
146. nbkmscmd
147. nbkmsutil
148. nboraadm
149. nborair
150. nbpem
151. nbpemreq
152. nbmariadb
153. nbmlb
154. nbperfchk
155. nbplupgrade
156. nbrb
157. nbrbutil
158. nbreplicate
159. nbrepo
160. nbrestorevm
161. nbseccmd
162. nbserviceusercmd
163. nbsetconfig
164. nbshvault
165. nbsmartdiag
166. nbsnapimport
167. nbsnapreplicate
168. nbsqladm
169. nbsqlite
170. nbstl
171. nbstlutil
172. nbstop
173. nbsu
174. nbsvrgrp
175. netbackup_deployment_insights
176. resilient_clients
177. restoretrace
178. stopltid
179. tldd
180. tldcd
181. tpautoconf
182. tpclean
183. tpconfig
184. tpext
185. tpreq
186. tpunmount
187. verifytrace
188. vltadm
189. vltcontainers
190. vlteject
191. vltinject
192. vltoffsitemedia
193. vltopmenu
194. vltrun
195. vmadd
196. vmchange
197. vmcheckxxx
198. vmd
199. vmdelete
200. vmoprcmd
201. vmphyinv
202. vmpool
203. vmquery
204. vmrule
205. vmupdate
206. vnetd
207. vssat
208. vwcp_manage
209. vxlogcfg
210. vxlogmgr
211. vxlogview
212. 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)。