NetBackup IT Analytics Data Collector 安装和配置指南（适用于Cohesity NetBackup ）

登录门户后：

1. 选择“管理”>“数据收集”>“收集器管理”。
2. 单击“添加收集器”。

要下载 .key 文件，请执行以下操作：

1. 登录门户，转到“管理”>“收集器管理”。
2. 选择刚才创建的 Data Collector，如步骤 2：在 NetBackup IT Analytics 门户中添加 Data Collector中所述。
3. 单击“编辑”。
4. 选择“密钥文件”。
5. 请注意以下信息：

   • Data Collector 的名称（门户上显示的名称）

   • Data Collector 的密码（门户上配置的密码）

   • 数据接收器 URL（在门户上创建 Data Collector 时生成）

   注意:

   从 NetBackup 主服务器执行的数据接收器 URL 中的主机名必须解析为门户服务器的 IP 地址。

6. 单击“生成”。

   此时将显示以下消息，表明已创建 .key 文件。配置和注册 Data Collector 11.2 和早期版本时全都需要使用该文件。

7. 请注意 .key 文件的路径。

要在 Windows 上使用 .key 文件手动配置 Data Collector，请执行以下操作：

1. 创建响应文件 responsefile.cmd 作为批处理脚本并包含所示内容。这些是配置 Data Collector 所需的用户输入响应。此外，安装程序介质中还提供了响应文件示例（位于 x64\ITA_DC\responsefile.cmd）。

   SET DATACOLLECTOR_NAME=name_of_the_data_collector 
   SET DATACOLLECTOR_PASSCODE=passcode_for_the_data_collector 
   SET DATARECEIVER_URL=data_receiver_URL 
   SET DATACOLLECTOR_KEY_FILE_PATH=path_to_the_key_file 
   SET HTTP_PROXY_CONF=N 
   SET PROXY_HTTP_URL= 
   SET PROXY_HTTP_PORT= 
   SET PROXY_HTTPS_URL= 
   SET PROXY_HTTPS_PORT= 
   SET PROXY_USERID= 
   SET PROXY_PASSWORD= 
   SET PROXY_NOT_FOR= 

   要在 Windows 上使用 .json 文件手动配置 Data Collector，请创建以下批处理脚本。此外，安装程序介质中还提供了响应文件示例（位于 x64\ITA_DC\responsefile.cmd）。

   SET DATACOLLECTOR_REGISTRATION_FILE_PATH=path of .json 
   SET HTTP_PROXY_CONF=N 
   SET PROXY_HTTP_URL= 
   SET PROXY_HTTP_PORT= 
   SET PROXY_HTTPS_URL= 
   SET PROXY_HTTPS_PORT= 
   SET PROXY_USERID= 
   SET PROXY_PASSWORD= 
   SET PROXY_NOT_FOR=

2. 使用相应数据更新每个字段的值。
3. 运行所示的命令：

   "C:\ProgramData\Veritas\NetBackup IT Analytics\DC\configure.cmd" 
   
   \RESPFILE:response_file_path \INSTALL_TYPE:CONFIG 

4. 通过访问 C:\Program Files\Veritas\analyticscollector\mbs\bin\ 并运行此命令，验证 Data Collector 与 NetBackup IT Analytics 的集成：checkinstall.bat。

   如果通过门户配置了 Data Collector，则响应将显示为“成功”。

   注意:

   从 NetBackup 主服务器执行的数据接收器 URL 中的主机名必须解析为门户服务器的 IP 地址。

要在 Linux 上使用 .key 文件手动配置 Data Collector，请执行以下操作：

1. 创建响应文件并包含所示内容。可从安装介质和主服务器上的 /usr/openv/analyticscollector/installer/responsefile.sample 获得响应文件示例。这些是配置 Data Collector 所需的用户输入响应：

   COLLECTOR_NAME=name_of_the_data_collector 
   COLLECTOR_PASSCODE=passcode_for_the_data_collector 
   DR_URL=data_receiver_URL 
   COLLECTOR_KEY_PATH=path_to_the_key_file 
   HTTP_PROXY_CONF=N 
   HTTP_PROXY_ADDRESS= 
   HTTP_PROXY_PORT= 
   HTTPS_PROXY_ADDRESS= 
   HTTPS_PROXY_PORT= 
   PROXY_USERNAME= 
   PROXY_PASSWORD= 
   PROXY_EXCLUDE=

   要在 Linux 上使用 .json 文件手动配置 Data Collector，请创建以下响应文件。可从安装介质和主服务器上的 /usr/openv/analyticscollector/installer/responsefile.sample 获得响应文件示例。

   COLLECTOR_REGISTRATION_PATH=<path-to-registration-file-downloaded-from-portal-including-filename>
   HTTP_PROXY_CONF=N
   HTTP_PROXY_ADDRESS=
   HTTP_PROXY_PORT=
   HTTPS_PROXY_ADDRESS=
   HTTPS_PROXY_PORT=
   PROXY_USERNAME=
   PROXY_PASSWORD=
   PROXY_EXCLUDE=

2. 使用相应数据更新每个字段的值。
3. 运行命令：

   /usr/openv/analyticscollector/installer/dc_installer.sh -c responsefile_path 

4. 通过导航到 /usr/openv/analyticscollector/mbs/bin/ and running ./checkinstall.sh，验证 Data Collector 与 NetBackup IT Analytics 的集成。如果 Data Collector 能够与 NetBackup IT Analytics 门户通信，则响应将显示为“成功”。

   注意:

   从 NetBackup 主服务器执行的数据接收器 URL 中的主机名必须解析为门户服务器的 IP 地址。

要为 NetBackup 部署配置 NetBackup IT Analytics，请执行以下操作：

1. 以必须可将门户的 IP 解析为单个 FQDN 的方式创建 DNS 服务器条目。 NetBackup IT Analytics 门户的 IP 必须解析为：

   itanalyticsagent.<yourdomain> 

   请注意以下几点：

   • 如果门户 URL 为 itanalyticsportal.<yourdomain>，请务必为以下主机名添加 DNS 条目：itanalyticsagent.<yourdomain>

   • 如果门户 URL 为 aptareportal.<yourdomain>，请务必为以下主机名添加 DNS 条目：aptareagent.<yourdomain>

   上述默认值基于已安装的初始 NetBackup IT Analytics 门户版本。

2. 根据 Data Collector 版本，通过访问门户链接并创建收集器，为新 Data Collector 收集 <your-collector-name>.key 或 <your-collector-name>.json 文件。将其复制到部署 NetBackup 主服务器的主机。

   如需了解更多信息，请参阅《NetBackup IT Analytics 用户指南》中的“Data Collector 加密”部分。

3. 使用以下命令在永久位置（例如 /mnt/nbdata/）创建一个新文件夹 analyticscollector：

   cd "/mnt/nbdata/" 
   mkdir analyticscollector 

4. 将 <your-collector-name>.key 或 <your-collector-name>.json 文件复制到 NetBackup 主服务器主机或容器中的 /mnt/nbdata/analyticscollector 下。
5. 如果数据接收器已配置自签名证书 (https)，则用户必须在 Data Collector 中添加该证书。

   请参见《NetBackup IT Analytics 管理指南》中的“配置 Data Collector 以信任证书”部分。

6. 连接到 NetBackup 主服务器主机或容器。
7. 导航到 /usr/openv/analyticscollector/installer/ 位置并执行以下操作。

   • 打开 responsefile.sample 并添加以下参数：

     如果 Data Collector 版本低于 11.3，请创建包含以下内容的响应文件。

     COLLECTOR_NAME=<your-collector-name>
     COLLECTOR_PASSCODE=<your-password>
     DR_URL=<http>/<https>://itanalyticsagent.<yourdomain> 
     COLLECTOR_KEY_PATH=<path to your-collector-name.key> 
     HTTP_PROXY_CONF=N 
     HTTP_PROXY_ADDRESS=
     HTTP_PROXY_PORT=
     HTTPS_PROXY_ADDRESS= 
     HTTPS_PROXY_PORT= 
     PROXY_USERNAME= 
     PROXY_PASSWORD= 
     PROXY_EXCLUDE=

     如果 Data Collector 版本为 11.3 或更高，请创建包含以下内容的响应文件。

     COLLECTOR_REGISTRATION_PATH=<path to .json file> 
     HTTP_PROXY_CONF=N 
     HTTP_PROXY_ADDRESS=
     HTTP_PROXY_PORT=
     HTTPS_PROXY_ADDRESS=
     HTTPS_PROXY_PORT=
     PROXY_USERNAME=
     PROXY_PASSWORD=
     PROXY_EXCLUDE=

8. 按以下步骤通过 NetBackup IT Analytics 门户配置 Data Collector。

   注意:

   如果安装的 Data Collector 版本低于门户，请等待 Data Collector 完成自动升级后再继续。

   对于 NetBackup Appliance 版本 5.3 或更高版本：

   • 以 NetBackup CLI 用户的身份运行以下命令：

     /usr/openv/analyticscollector/installer/dc_installer.sh -c /usr/openv/analyticscollector/installer/responsefile.sample

   • 如要验证 Data Collector 是否已与 NetBackup IT Analytics 门户集成，请运行：

     /usr/openv/analyticscollector/mbs/bin/checkinstall.sh

   对于 NetBackup Appliance 版本 5.1.1：

   • 以 NetBackup CLI 用户的身份运行以下命令：

     sudo /usr/openv/analyticscollector/installer/dc_installer.sh -c /usr/openv/analyticscollector/installer/responsefile.sample

   • 如要验证 Data Collector 是否已与 NetBackup IT Analytics 门户集成，请运行：

     sudo /usr/openv/analyticscollector/mbs/bin/checkinstall.sh

   如果您使用的是 Flex Appliance：

   • 连接到主服务器容器，然后使用 sudo 切换为 root 用户并运行：

     /usr/openv/analyticscollector/installer/dc_installer.sh -c /usr/openv/analyticscollector/installer/responsefile.sample

   • 如要验证 Data Collector 是否已与 NetBackup IT Analytics 门户集成，请运行：

     /usr/openv/analyticscollector/mbs/bin/checkinstall.sh 

   如果已通过门户配置 Data Collector，将显示为“成功”。

   注意:

   如果 Data Collector 与门户之间的 aptare.jar 版本不匹配，执行 checkinstall.sh 命令将触发 Data Collector 的自动更新。如果 Data Collector 能够与 NetBackup IT Analytics 门户通信，则响应将显示为“成功”。

9. 通过运行以下命令检查 Data Collector 服务的状态，并确保以下 Data Collector 服务已启动且正在运行：

   /usr/openv/analyticscollector/mbs/bin/aptare_agent status 

   上述命令的输出：

   IT Analytics Zookeeper Server is running (pid: 16137). 
   IT Analytics Kafka Server is running (pid: 16145). 
   IT Analytics WatchDog is running (pid: 7225). 
   IT Analytics MetaDataCollector is stopped.
   IT Analytics EventDataCollector is stopped.
   IT Analytics DataCollector process is running (pid: 7365).
   IT Analytics On-demand process is running (pid: 7361).
   IT Analytics Message Relay Server process is running (pid: 7366).
   

要为 NetBackup 部署配置 NetBackup IT Analytics，请执行以下操作：

1. 以必须可将 NetBackup IT Analytics 门户的 IP 解析为单个 FQDN 的方式创建 DNS 服务器条目。 NetBackup IT Analytics 门户的 IP 必须解析为：

   itanalyticsagent.<yourdomain>
   

   请注意以下几点：

   • 如果门户 URL 为 itanalyticsportal.<yourdomain>，请务必为以下主机名添加 DNS 条目：

     itanalyticsagent.<yourdomain> 
     

   • 如果门户 URL 为 aptareportal.<yourdomain>，请务必为以下主机名添加 DNS 条目：

     aptareagent.<yourdomain>
     

2. 根据 Data Collector 版本，通过访问门户链接并创建收集器来收集新 Data Collector 的 <your-collector-name>.key 或 <your-collector-name>.json 文件，然后将其复制到访问 Kubernetes 群集所用的主机上。如需了解更多信息，请参阅《NetBackup IT Analytics 用户指南》中的“Data Collector 加密”部分。
3. 使用以下命令将 <your-collector-name>.key 或 <your-collector-name>.json 文件复制到 NetBackup 主服务器 Pod 中的 /mnt/nbdata/analyticscollector 下：

   kubectl cp <keyfile-name> <namespace>/<primary-pod-name>:/mnt/nbdata/analyticscollector

4. 如果数据接收器已配置自签名证书 (https)，则必须在 Data Collector 中添加该证书。
5. 在主服务器 Pod 上执行以下命令：

   kubectl exec -it -n <namespace> <primaryServer-pod-name> -- bash

6. 导航到 /usr/openv/analyticscollector/installer/ 位置并执行以下操作：

   • 如果门户版本低于 11.3，请创建包含以下内容的响应文件。

     COLLECTOR_NAME=<your-collector-name>
     COLLECTOR_PASSCODE=<your-password>
     DR_URL=<http>/<https>://itanalyticsagent.<yourdomain>
     COLLECTOR_KEY_PATH=<path to your-collector-name.key>
     HTTP_PROXY_CONF=N
     HTTP_PROXY_ADDRESS=
     HTTP_PROXY_PORT=
     HTTPS_PROXY_ADDRESS=
     HTTPS_PROXY_PORT=
     PROXY_USERNAME=
     PROXY_PASSWORD=
     PROXY_EXCLUDE=
     

     如果门户版本为 11.3 或更高，请创建包含以下内容的响应文件。

     COLLECTOR_REGISTRATION_PATH=<keyfile path>
     HTTP_PROXY_CONF=N
     HTTP_PROXY_ADDRESS=
     HTTP_PROXY_PORT=
     HTTPS_PROXY_ADDRESS=
     HTTPS_PROXY_PORT=
     PROXY_USERNAME=
     PROXY_PASSWORD=
     PROXY_EXCLUDE=

   • 运行此命令以通过门户配置 Data Collector。

     /usr/openv/analyticscollector/installer/dc_installer.sh -c /usr/openv/analyticscollector/installer/responsefile.sample

7. 通过执行以下操作对 Data Collector 与 NetBackup IT Analytics 的集成进行验证：

   • 转到 usr/openv/analyticscollector/mbs/bin/。

   • 运行命令：

     ./checkinstall.sh 

   如果已通过门户配置 Data Collector，将显示为“成功”。

   注意:

   如果 Data Collector 与门户之间的 aptare.jar 版本不匹配，执行 checkinstall.sh 命令将触发 Data Collector 的自动更新。

8. 通过运行以下命令检查 Data Collector 服务的状态，并确保以下 Data Collector 服务已启动且正在运行：

   /usr/openv/analyticscollector/mbs/bin/aptare_agent status

   上述命令的输出：

   IT Analytics Zookeeper Server is running (pid: 16137).
   IT Analytics Kafka Server is running (pid: 16145).
   IT Analytics WatchDog is running (pid: 7225).
   IT Analytics MetaDataCollector is stopped.
   IT Analytics EventDataCollector is stopped.
   IT Analytics DataCollector process is running (pid: 7365).
   IT Analytics On-demand process is running (pid: 7361).
   IT Analytics Message Relay Server process is running (pid: 7366)
   
   

1. 登录到 NetBackup IT Analytics 门户。
2. 转到“管理”>“数据收集”>“收集器管理”，并验证 Data Collector 是否显示为“联机”。