Ransomware attackers specifically target and attempt to destroy backup systems to increase the probability of payment. Hardening your system is critical. Please ensure you have reviewed your platform security using the Security Hardening Checklist
Cohesity

COHESITY Documentation

Explore our documentation to get started, discover products & new features, access troubleshooting guides, register sources, platforms support.

Products
Data Security Alliance
Visit Cohesity.com
Demos
Support
Blogs
Developers
Partner Portals
Cohesity Community
© 2026 Cohesity, Inc. All Rights Reserved.
Terms of Use|
Privacy Policy|
Legal|
  1. Home
  2. NetBackup™ Upgrade Guide
  3. Appendix A. Reference
  4. Manually configure the IT Analytics Data Collector
NetBackup™ Upgrade Guide

Manually configure the IT Analytics Data Collector

The primary server installation deploys the IT Analytics Data Collector binaries automatically as part of a successful NetBackup installation. The binaries are installed to install_path\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 Cohesity Alta or IT Analytics Portal).

  • Passcode of the Data Collector (as configured on the Cohesity Alta or IT Analytics Portal).

  • Data receiver URL (generated when you create the Data Collector on the Cohesity Alta or 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 Cohesity Alta or IT Analytics Portal and copied to the NetBackup primary server).

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

To configure the Data Collector manually on Windows:

  1. 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=
  2. 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.
  3. Run the command shown:
    "C:\ProgramData\Veritas\NetBackup IT Analytics\DC\configure.cmd"
    \RESPFILE:response_file_path \INSTALL_TYPE:CONFIG
  4. Validate the Data Collector integration with IT Analytics by going to install_path\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:

  1. 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=
  2. 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.

  3. Run the command:
    /usr/openv/analyticscollector/installer/dc_installer.sh -c responsefile_path
  4. Validate the Data Collector integration with IT Analytics by navigating to /usr/openv/analyticscollector/mbs/bin/ and running ./checkinstall.sh

    If the Data Collector is able to communicate with the 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 IT Analytics Portal, then to edit any of the Data Collector properties on the Portal, refer to Edit IT Analytics Data Collector credentials section in the IT Analytics User Guide.

Feedback

Was this page helpful?
Previous

Manually install or uninstall IT Analytics Data Collector binaries

Next

Manually upgrading the IT Analytics Data Collector

Feedback

Was this page helpful?