搜索 <book_title>...

NetBackup™ 命令参考指南

Last Published: 2022-04-27

Product(s): NetBackup & Alta Data Protection (10.0)

介绍
附录 A. NetBackup 命令
1. acsd
2. add_media_server_on_clients
3. backupdbtrace
4. backuptrace
5. bmrc
6. bmrconfig
7. bmrepadm
8. bmrprep
9. bmrs
10. bmrsrtadm
11. bp
12. bparchive
13. bpbackup
14. bpbackupdb
15. bpcatarc
16. bpcatlist
17. bpcatres
18. bpcatrm
19. bpcd
20. bpchangeprimary
21. bpcleanrestore
22. bpclient
23. bpclimagelist
24. bpclntcmd
25. bpclusterutil
26. bpcompatd
27. bpconfig
28. bpdbjobs
29. bpdbm
30. bpdgclone
31. bpdown
32. bpduplicate
33. bperror
34. bpexpdate
35. bpfis
36. bpflist
37. bpgetconfig
38. bpgetdebuglog
39. bpimage
40. bpimagelist
41. bpimmedia
42. bpimport
43. bpinst
44. bpkeyfile
45. bpkeyutil
46. bplabel
47. bplist
48. bpmedia
49. bpmedialist
50. bpminlicense
51. bpnbat
52. bpnbaz
53. bppficorr
54. bpplcatdrinfo
55. bpplclients
56. bppldelete
57. bpplinclude
58. bpplinfo
59. bppllist
60. bpplsched
61. bpplschedrep
62. bpplschedwin
63. bppolicynew
64. bpps
65. bprd
66. bprecover
67. bprestore
68. bpretlevel
69. bpschedule
70. bpschedulerep
71. bpsetconfig
72. bpstsinfo
73. bpstuadd
74. bpstudel
75. bpstulist
76. bpsturep
77. bptestbpcd
78. bptestnetconn
79. bptpcinfo
80. bpup
81. bpverify
82. cat_convert
83. cat_export
84. cat_import
85. configureCerts
86. configureMQ
87. configurePorts
88. configureWebServerCerts
89. create_nbdb
90. csconfig cldinstance
91. csconfig cldprovider
92. csconfig meter
93. csconfig reinitialize
94. csconfig throttle
95. duplicatetrace
96. importtrace
97. jbpSA
98. jnbSA
99. ltid
100. mklogdir
101. nbauditreport
102. nbcallhomeproxyconfig
103. nbcatsync
104. NBCC
105. NBCCR
106. nbcertcmd
107. nbcertupdater
108. nbcldutil
109. nbcloudrestore
110. nbcomponentupdate
111. nbcplogs
112. nbcredkeyutil
113. nbdb_admin
114. nbdb_backup
115. nbdb_move
116. nbdb_ping
117. nbdb_restore
118. nbdb_unload
119. nbdb2adutl
120. nbdbms_start_server
121. nbdbms_start_stop
122. nbdc
123. nbdecommission
124. nbdelete
125. nbdeployutil
126. nbdevconfig
127. nbdevquery
128. nbdiscover
129. nbdna
130. nbemm
131. nbemmcmd
132. nbfindfile
133. nbfirescan
134. nbfp
135. nbftadm
136. nbftconfig
137. nbgetconfig
138. nbhba
139. nbholdutil
140. nbhostidentity
141. nbhostmgmt
142. nbhypervtool
143. nbidpcmd
144. nbimageshare
145. nbinstallcmd
146. nbjm
147. nbkmiputil
148. nbkmscmd
149. nbkmsutil
150. nboraadm
151. nborair
152. nbpem
153. nbpemreq
154. nbmlb
155. nbperfchk
156. nbplupgrade
157. nbrb
158. nbrbutil
159. nbregopsc
160. nbreplicate
161. nbrepo
162. nbrestorevm
163. nbseccmd
164. nbserviceusercmd
165. nbsetconfig
166. nbsmartdiag
167. nbsnapimport
168. nbsnapreplicate
169. nbsqladm
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
索引

名称

netbackup_deployment_insights — 一款使用情况报告工具，用于收集、分析和报告有关客户端和容量的主服务器信息

大纲

netbackup_deployment_insights --debug-inputs dir1 [dir2dir3]

netbackup_deployment_insights --gather [--bpimagelist=options] <--capacity ¦ --traditional> [--client hostname1, [hostname2, ...] | --clientlist=filename] [--hoursago=number] [--log=filename] [--master=hostname] [--nolog] [--output=directory] [--runtimestats] [-start date [-end date]] [--client-timeout seconds] [--exclude-clients client1[,client2,...]] [--exclude-clientlist path] [--exclude-all-clients]

netbackup_deployment_insights --report <--capacity ¦ --traditional> [--day-boundary=time] [dir1 dir2 dir# | --dirsfile=filename | --parentdir=directory] [--log=filename] [--nolog] [--overlap-details] [--runtimestats]

netbackup_deployment_insights --retry dir1 [dir2dir#]

netbackup_deployment_insights --version

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

On Windows systems, the directory path to this command is install_path\NetBackup\bin\admincmd\

描述

在 NetBackup 9.1 中，nbdeployutil 已重命名为 netbackup_deployment_insights。Veritas 建议手动生成许可证报告时使用 netbackup_deployment_insights 命令。您可以继续使用 nbdeployutil 命令和相同的选项。

netbackup_deployment_insights 工具从主服务器收集并分析部署信息。该工具根据两个 NetBackup 授权许可模式之一（传统授权或容量授权）执行部署分析。传统授权部署分析会计算客户端和服务器的数量，然后将此信息与获得许可的选件进行比较。容量授权部署分析会计算受保护的源数据量。

该命令分两个步骤运行。netbackup_deployment_insights 在第一步收集数据，在第二步分析数据。

netbackup_deployment_insights 命令支持增量式报告。通过该功能，netbackup_deployment_insights 将根据指定的频率运行，以增量方式收集数据并生成基于容量的许可报告。有关如何启用和使用该功能的更多信息，请参见 NetBackup 管理指南，第 II 卷。

该工具在收集期间将生成名为 nbdeployutil-gather-timestamp.log 的日志文件。该工具在分析和生成报告期间将生成名为 nbdeployutil-report-timestamp.log 的日志文件。默认情况下，这些日志文件是在收集的数据所在的目录中创建的。

有关传统的和基于容量的许可的更多信息，请参见 NetBackup 管理指南，第 II 卷。

注意:

必须配置增强审核并添加特定用户，才能以非 root 用户身份使用 netbackup_deployment_insights。有关增强审核的更多信息，请参见 NetBackup 安全和加密指南。

操作

--client-timeout seconds

此选项在 nbdeployutil 中强制 bptestbpcd 的超时，而不依赖于 NetBackup 配置。

仅当指定了 --gather 选项时，此选项才适用。如果指定了 --capacity，则此选项不适用。

--debug-inputs

将用于生成报告的文件转换为用户可读的格式。这些新文件比原始输出更方便阅读。只能指定包含基本 ASCII 字符的目录。不支持带有扩展 ASCII 字符的目录。

--exclude-all-clients

使用此选项，可以从 bptestbpcd 连接中排除所有客户端。指定的客户端在报告中显示为不可连接。

仅当指定了 --gather 选项时，此选项才适用。如果指定了 --capacity，则此选项不适用。

--exclude-clientlist path

使用此选项，可以指定包含要从 bptestbpcd 连接中排除的客户端列表的文件。每个客户端名称将单独列在文件中的一行内。指定的客户端在报告中显示为不可连接。

仅当指定了 --gather 选项时，此选项才适用。如果指定了 --capacity，则此选项不适用。

--exclude-clients client1[,client2,...]

使用此选项，可以从 bptestbpcd 连接中排除任何指定的客户端。指定的客户端在报告中显示为不可连接。

仅当指定了 --gather 选项时，此选项才适用。如果指定了 --capacity，则此选项不适用。

--gather

收集数据以便使用 report 选项进行分析。在使用 --gather 操作时，必须使用 capacity 或 traditional 参数。仅收集指定授权模式（capacity 或 traditional）的数据。

在容量授权或传统授权模式下运行 netbackup_deployment_insights --gather 命令时，系统会提示您输入其他信息。必须输入显示用于对 NetBackup Web 管理服务进行身份验证的凭据信息：

域类型：输入的域类型值包括：NIS、NISPLUS、WINDOWS、vx、unixpwd、ldap。该值区分大小写。
域名：主服务器主机所属的域的名称。如果主服务器不属于任何域，则输入主服务器的名称。
用户名：具有管理员权限的用户的名称。
密码：具有管理员权限的同一用户的密码。输入密码时，字符不会特意显示在命令行中。

在多主服务器的情况下，必须输入 gather 命令提及的所有主服务器的凭据。

--report

基于通过 gather 选项收集的数据生成许可报告。指定供该工具用于报告的目录或目录列表。在使用 --report 操作时，必须使用 capacity 或 traditional 参数。

--retry

重新运行收集操作，并尝试重新连接到收集过程中失败的主机（由收集目录中的信息确定）。当报告多个主机无法访问时，此操作对传统授权模型很有用。

--version

返回该命令的版本。此选项用于识别运行该命令的最新 NetBackup 产品版本。版本字符串还可指示该工具的特殊版本，例如工程二进制文件。如果已将工具手动复制到 7.1 版本之前的主服务器，则此选项很有用。

选项

--bpimagelist

用于在该过程的 gather 阶段将特定选项传递给 bpimagelist 命令。

--capacity

指定要与 gather 或 report 结合使用的授权模式。使用 capacity 可根据 NetBackup 的每 TB 容量授权模型来报告部署情况。

--client 或 --clientlist

仅收集或报告所指定的某个或一系列客户端的数据。使用 client 时，请以逗号分隔多个客户端。要使用 clientlist 参数，请在 filename 中在不同的行上列出各个客户端。使用 --client 或 --clientlist 选项时，报告可能会将某些介质服务器显示为无法连接，即使工具可以连接到这些服务器。此问题不会影响摘要信息。

--day-boundary

改变用于创建报告的报告窗口的起始时间。默认报告时段始于午夜，并运行到晚上 11:59:59。以 24 小时表示法将 time 值指定为 hh:mm，其中，早上 6:00 表示为 06:00，晚上 6:00 表示为 18:00。

--dirsfile

一个包含目录列表的文件，report 参数将使用这些目录生成报告。此参数是在 report 参数后列出所有文件的替代方法。您还可以使用 parentdir 参数列出供 report 参数使用的父目录。

--end

指定收集期限的受限日期范围的结束日期。此选项只能与 start 选项结合使用。此参数的格式为 "MM/DD/YYYY hh:mm:ss"。以 24 小时表示法指定时间值 hh:mm:ss，其中，早上 6:00 表示为 06:00:00，晚上 6:00 表示为 18:00:00。日期时间值必须用双引号括起来。

--hoursago

更改映像收集时间间隔的默认值。以小时为单位指定该值。默认值为 2160 小时（90 天）。

--log

将日志强制输出到特定的日志文件。默认情况下，日志输出会写入所收集的数据和报告的存储目录中的日志文件。

--master

收集指定主服务器的容量授权数据。此选项只能与 --gather 结合使用。要使本地主机能够从远程服务器收集数据，主机名必须显示在该远程服务器的服务器列表中。

此选项仅支持远程收集的容量授权信息，不支持远程收集的传统授权数据。

--nolog

禁止创建调试日志文件。

--output

将结果保存在所指定的输出目录中。只能指定包含基本 ASCII 字符的目录。不支持带有扩展 ASCII 字符的目录。如果操作是 gather，则输出目录将保存收集的数据。对于 report 操作，报告和日志文件将被置于输出目录中，而不是与收集的数据一起位于指定的输入目录中。如果未指定 output 选项，则输出内容将被置于以下目录：

对于 UNIX：/usr/openv/var/global/reports/ YYYYMMDD_hhmmss_masterserver
对于 Windows：install_path\NetBackup\var\global\reports\YYYYMMDD_hhmmss_masterserver

--overlap-details

显示容量授权报告的“重复的选择项”列中的重复备份选择项。此选项仅可用于 ASCII 或备份选择数据中的仅限英文字符。

--parentdir

指定目录树的顶层目录（目录树中包含许多目录，这些目录内有收集的许可数据），report 参数应使用这些数据生成报告。您也可以使用 dirsfile 参数指定一个包含目录列表的文件。

--runtimestats

显示工具的运行时统计信息。统计数据包括内存和 CPU 使用量。

UNIX 输出示例：

stats  mem 40.1 M, cpu 27.0% after splitting t/fixture/
nbdeployutil_sidon/bpimagelist_sidon.out
stats  mem 40.1 M, cpu 28.0% after parsing records from t/fixture/
nbdeployutil_sidon/tmp/policy_db_arc_tab_2gig_nt_client_totem7.out
stats  mem 40.6 M, cpu 50.0% after calculating for UNKNOWN-1 in 
t/fixture/nbdeployutil_sidon/ stats  mem 40.6 M, cpu 51.0% after 
main report loop took 1 sec

--start

指定收集期限的受限日期范围的开始日期。此参数的格式为 "MM/DD/YYYY hh:mm:ss"。以 24 小时表示法指定时间值 hh:mm:ss，其中，早上 6:00 表示为 06:00:00，晚上 6:00 表示为 18:00:00。请注意，日期时间值两边的双引号是必需的。

--traditional

与 gather 或 report 结合使用，用以指定授权模式。使用 --traditional 可根据 NetBackup 的每服务器传统授权模型来报告部署情况。默认值为 2160 小时（90 天）。

--verbose

将工具的详细进度信息输出到屏幕，这对调试日志文件中的信息没有影响。该日志文件的内容始终很详细。

前提条件

以下是 netbackup_deployment_insights 工具的前提条件：

主服务器后台驻留程序或服务必须在环境中运行，才能收集数据。
确认运行 gather 命令的主服务器上有足够的磁盘空间。收集容量授权数据时，将会收集前 90 天的 bpimagelist 输出。输出大小是目录库中该期限内的映像数的函数。可以移动或缩小默认时间段。分析时间较短将导致数字不准确或不完整。
查看报告需要使用 Microsoft Excel。不必在主服务器上安装该软件。

示例

示例 1 - 收集容量授权报告的数据。该目录路径适用于 UNIX 系统，但是此示例也适用于 Windows 系统。

# ./netbackup_deployment_insights --gather --capacity
NetBackup Deployment Insights, version 9.0.1
Gathering license deployment information...
  Discovered master server punnbuucsm5b38-vm80

Enter credentials for Master Server(s):

Master Server:punnbuucsm5b38-vm80
Domain Type (NIS, NISPLUS, WINDOWS, vx, unixpwd, ldap):unixpwd
Domain Name  :punnbuucsm5b38-vm80
User Name    :root
Password     :

Data gather is in progress. This process might take some time.
  Output for punnbuucsm5b38-vm80 at: /usr/openv/var/global/reports/
20210309_101511_punnbuucsm5b38-vm80
Gather DONE
Execution time: 25 secs
To create a report for this master server, run the following:
  netbackup_deployment_insights --report --capacity /usr/openv/var/global/
reports/20210309_101511_punnbuucsm5b38-vm80
#

示例 2 - 使用示例 1 的数据生成容量授权报告。该目录路径适用于 UNIX 系统，但是此示例也适用于 Windows 系统。

# ./netbackup_deployment_insights --report --capacity /usr/openv/var/
global/reports/20210309_101511_punnbuucsm5b38-vm80
NetBackup Deployment Insights, version 9.0.1
Analyzing license deployment ...
  Report created at: /usr/openv/var/global/reports/
20210309_101511_punnbuucsm5b38-vm80/report-capacity-punnbuucsm5b38-
vm80-20210309_101705.xls
Analysis DONE
Execution time: 0 sec
#

示例 3 - 收集传统授权报告的数据。该目录路径适用于 UNIX 系统，但是此示例也适用于 Windows 系统。

# ./netbackup_deployment_insights --gather --traditional
NetBackup Deployment Insights, version 9.0.1
Gathering license deployment information...
  Discovered master server punnbuucsm5b38-vm80
  Output for punnbuucsm5b38-vm80 at: /usr/openv/var/global/reports/
20210309_101809_punnbuucsm5b38-vm80
Gather DONE
Execution time: 9 secs
To create a report for this master server, run the following:
  netbackup_deployment_insights --report --traditional /usr/openv/var/
global/reports/20210309_101809_punnbuucsm5b38-vm80
#

示例 4 - 使用示例 3 的数据生成传统授权报告。该目录路径适用于 UNIX 系统，但是此示例也适用于 Windows 系统。

# ./netbackup_deployment_insights --report --traditional /usr/openv/var/
global/reports/20210309_101809_punnbuucsm5b38-vm80
NetBackup Deployment Insights, version 9.0.1
Analyzing license deployment ...
  Report created at: /usr/openv/var/global/reports/
20210309_101809_punnbuucsm5b38-vm80/report-traditional-punnbuucsm5b38-
vm80-20210309_101945.xls
Analysis DONE
Execution time: 1 sec
#

另请参见

请参见bpimagelist (1m)。

请参见nbdeployutil (1m)。