Search <book_title>...

NetBackup™ Upgrade Guide

Last Published: 2024-03-27

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

Manually configure the NetBackup IT Analytics Data Collector

The primary server installation deploys the NetBackup IT Analytics Data Collector binaries automatically as part of a successful NetBackup installation. The binaries are installed to install_path\Veritas\AnalyticsCollector (Windows) or /usr/openv/analyticscollector (Linux). This section details the steps that are required to manually configure the Data Collector.

Keep the following details handy when you configure the Data Collector:

Name of the Data Collector (as configured on the Veritas Alta or NetBackup IT Analytics Portal).
Passcode of the Data Collector (as configured on the Veritas Alta or NetBackup IT Analytics Portal).
Data receiver URL (generated when you create the Data Collector on the Veritas Alta or NetBackup IT Analytics Portal). Ensure the NetBackup primary server can resolve the host name of the Data Receiver URL.
Key file path (generated when you create the Data Collector on the Veritas Alta or NetBackup IT Analytics Portal and copied to the NetBackup primary server).

See the Add/Edit Data Collectors section in the NetBackup IT Analytics User Guide for more information.

To configure the Data Collector manually on Windows:

Create a response file as a batch script responsefile.cmd with the contents shown. These are the responses to the user input required to configure the Data Collector.

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=

Update the value for each field with appropriate data. A sample response file is also available in the installer media in x64\ITA_DC\responsefile.cmd.

Run the command shown:

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

Validate the Data Collector integration with NetBackup IT Analytics by going to C:\Program Files\Veritas\analyticscollector\mbs\bin\ and running this command:
```
checkinstall.bat
```
If the Data Collector is configured with the Portal, the response is displayed as SUCCESSFUL.
Note:
If there is a version mismatch of aptare.jar between the Data Collector and the portal, execution of the checkinstall.bat command starts an auto-update of the Data Collector.

To configure the Data Collector manually on Linux:

Create a response file with the contents shown. These are the responses to the user input required to configure the 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=

Update the value for each field with appropriate data.
A sample response file is available on the install media and from /usr/openv/analyticscollector/installer/responsefile.sample on the primary server.

Run the command:

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

Validate the Data Collector integration with NetBackup IT Analytics by navigating to /usr/openv/analyticscollector/mbs/bin/ and running ./checkinstall.sh
If the Data Collector is able to communicate with the NetBackup IT Analytics Portal, the response is displayed as SUCCESSFUL.
Note:
If there is a version mismatch of aptare.jar between the Data Collector and the portal, execution of the checkinstall.sh command starts an auto-update of the Data Collector.

Start, stop, and get the status of the Data Collector

On Linux:

To start the Data Collector processes, run:

/usr/openv/analyticscollector/mbs/bin/aptare_agent start

To stop the Data Collector processes, run:

/usr/openv/analyticscollector/mbs/bin/aptare_agent stop

To get the status of the Data Collector processes, run:

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

On Windows: Review the status of Aptare Agent, Aptare Kafka, and Aptare Zookeeper services on the Windows service panel.

Note:

If the Data Collector is configured with an on-premises NetBackup IT Analytics Portal, then to edit any of the Data Collector properties on the Portal, refer to Edit NetBackup IT Analytics Data Collector credentials section in the NetBackup IT Analytics User Guide.