Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
nbdeployutil — 这是一个部署实用程序,用于收集并分析有关客户端和容量的主服务器信息
大纲
--debug-inputs dir1 [dir2dir3]
--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]
--report [--capacity ¦ --traditional] [--day-boundary=time] [dir1 dir2 dir# | --dirsfile=filename | --parentdir=directory] [--log=filename] [--nolog] [--overlap-details] [--runtimestats]
--retry dir1 [dir2dir#]
--version
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
nbdeployutil 实用程序从主服务器收集部署信息并进行分析。该实用程序根据两个 NetBackup 许可模式之一(传统许可或容量许可)执行部署分析。传统许可部署分析会计算客户端和服务器的数量,然后将此信息与获得许可的选件进行比较。容量许可部署分析会计算受保护的源数据量。
该命令分两个步骤运行。nbdeployutil 在第一步收集数据,在第二步分析数据。
nbdeployutil 命令支持增量式报告。通过该功能,nbdeployutil 将根据指定的频率运行,以增量方式收集数据并生成基于容量的许可报告。有关如何启用和使用该功能的更多信息,请参见 NetBackup 管理指南,第 II 卷。
该实用程序在收集操作期间将生成一个名为 nbdeployutil-gather-timestamp.log
的日志文件,在分析和报告生成操作期间将生成一个名为 nbdeployutil-report-timestamp.log
的日志文件。默认情况下,这些日志文件是在收集的数据所在的目录中创建的。
有关传统的和基于容量的许可的更多信息,请参见 NetBackup 管理指南,第 II 卷。
操作
- --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 选项进行分析。如果使用了 capacity 或 traditional 参数,则只会收集该特定许可模型的数据。如果 capacity 和 traditional 均未指定,gather 将收集这两种许可模型的数据。
在 NetBackup 8.0 或更高版本的主服务器上,在容量许可模式下运行 nbdeployutil --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
将实用程序的详细进度信息输出到屏幕,这对调试日志文件中的信息没有影响。该日志文件的内容始终很详细。
前提条件
nbdeployutil 实用程序的前提条件如下:
主服务器后台驻留程序或服务必须在环境中运行,才能收集数据。
确认运行 gather 命令的主服务器上有足够的磁盘空间。收集容量许可数据时,将会收集前 90 天的 bpimagelist 输出。输出大小是目录库中该期限内的映像数的函数。可以移动或缩小默认时间段。分析时间较短将导致数字不准确或不完整。
查看报告需要使用 Microsoft Excel。不必在主服务器上安装该软件。
示例
示例 1 - 为 NetBackup 的容量许可模型和传统许可模型创建部署分析报告。目录路径是 Windows 系统的,但此示例也适用于 UNIX 系统。
# nbdeployutil --gather NetBackup Deployment Utility, version 7.1.0000.0000 Gathering license deployment information... Discovered master server marybl2g1 Output for marybl2g1 at: D:\Program Files\VERITAS\netbackup\ var\global\reports\20101029_170534_marybl2g1 Gather DONE Execution time: 1 min To create a report for this master server, run the following: nbdeployutil.exe --report "D:\Program Files\VERITAS\netbackup\ var\global\reports\20101029_170534_marybl2g1" D:\>nbdeployutil.exe --report --traditional "D:\Program Files\ VERITAS\netbackup\var\global\reports\ 20101029_170534_marybl2g1" NetBackup Deployment Utility, version 7.1.0000.0000 Analyzing license deployment for master marybl2g1 ... Report created at: D:\Program Files\VERITAS\netbackup\var\global\ reports\20101029_170534_marybl2g1\report-20101029_170705.xls Analysis DONE Execution time: 27 secs
示例 2 - 目标部署容量分析。该命令在非默认时段内收集一部分客户端的数据。目录路径是 Windows 系统的,但此示例也适用于 UNIX 系统。
# nbdeployutil.exe --gather --output pickedclient --start "11/01/10 06:00:00" --end "11/02/10 01:00:00" --clients marybl2g1,marybl7g1 / --verbose NetBackup Deployment Utility, version 7.1.0000.0000 Gathering license deployment information... run: bpgetconfig Discovered master server marybl2g1 run: bpimagelist -M marybl2g1 -d "11/01/10 06:00:00" -e "11/02/10 01:00:00" -l -client marybl2g1 run: bpimagelist -M marybl2g1 -d "11/01/10 06:00:00" -e "11/02/10 01:00:00" -l -client marybl7g1 Output for marybl2g1 at: pickedclient\20101102_155246_marybl2g1 Gather DONE Execution time: 4 secs To create a report for this master server, run the following: nbdeployutil.exe --report "pickedclient\20101102_155246_marybl2g1" D:\># nbdeployutil.exe --report --capacity pickedclient\ 20101102_154010_marybl2g1 --start "11/01/10 06:00:00" --end "11/02/10 01:00:00" --clients marybl2g1, marybl7g1 --verbose NetBackup Deployment Utility, version 7.1.0000.0000 Analyzing license deployment ... Master marybl2g1 Report created at: pickedclient\20101102_154010_marybl2g1\ report-20101102_155414.xls Analysis DONE Execution time: 2 secs
另请参见
请参见bpimagelist(1m)。