NetBackup™ 命令参考指南

使用此选项可指定包含 NetBackup API 密钥的文件路径。文件格式如下所示：

NetBackup primary server hostname : APIKey

可以有多个 NetBackup 主服务器主机名条目。将每个主服务器及其对应的 API 密钥文件置于新的一行中。netbackup_deployment_insights 命令使用与其连接到的 NetBackup 主服务器主机对应的 API 密钥。

NetBackup primary server hostname 1 : APIKey 1
NetBackup primary server hostname 2 : APIKey 2
NetBackup primary server hostname n : APIKey n

Veritas 建议使用 API 密钥对用户进行 NetBackup Web 管理服务身份验证。如果配置了多重身份验证，则必须使用 API 密钥。对于多个 NetBackup 域，请确保为所有主服务器提供 API 密钥。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

用于指定文件，NetBackup 读取此文件以获取用户身份验证的凭据。使用此选项允许 NetBackup 读取此信息，而无需提示用户输入。您还可以在文件中为多个主服务器指定凭据。

凭据文件必须具有按指定顺序显示的信息。每个项目都位于自己的行中。对于每个其他主服务器，请重复此顺序（不带空行）。

Primary server name
Domain type
Domain name
Username
Password

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

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

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

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

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

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

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

禁止创建调试日志文件。

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

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

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

显示工具的运行时统计信息。统计数据包括内存和 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

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

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

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