Important Update: Cohesity Products Documentation

All Cohesity product documentation are now managed via the Cohesity Docs Portal: https://docs.cohesity.com/HomePage/Content/home.htm. Some documentation available here may not reflect the latest information or may no longer be accessible.

IT Analytics Installation and Upgrade Guide for Linux

Last Published:
Product(s): NetBackup IT Analytics (11.7)
  1. Installation overview
    1.  
      Introduction
    2.  
      IT Analytics components
    3.  
      Standard or Shared Services licensing edition
    4.  
      Install options
    5.  
      Multi-language support and locale considerations (Linux)
    6.  
      Third-party and open source products used
  2. Install IT Analytics on a Linux server
    1.  
      Step-1: Get the IT Analytics license key file
    2.  
      Step-2: Portal and database deployment strategies
    3.  
      Step-3: Portal and database prerequisites
    4. Step-4: Install Oracle database application binaries
      1.  
        Create database and users in existing Oracle farm in a Split Architecture deployment
    5.  
      Step-5: Install the Portal application binaries (Linux)
    6.  
      Step-6: Start the Portal services (Linux)
    7.  
      Step-7: Log into the Portal
    8.  
      Step-8: Install a license
    9. Verify the current license configuration
      1.  
        Run the License Summary report
      2.  
        About IT Analytics version and license
      3.  
        View License Details
    10. Next steps
      1.  
        Perform a cold backup of the database
      2.  
        Recommended database backup process
  3. Upgrade IT Analytics Portal on Linux
    1.  
      Overview
    2.  
      Upgrade path
    3.  
      Before upgrading
    4. Upgrade IT Analytics Portal
      1.  
        Upgrade a shared services environment
      2.  
        Run the upgrade utility installer (Linux)
      3.  
        Known issues
      4.  
        Run the upgrade utility
      5.  
        After the upgrade
      6.  
        Upgrade methods to incorporate enterprise objects
      7. Attribute merging during the Portal upgrade
        1.  
          Attribute Management During the Portal Upgrade
        2.  
          Example of a Merge of Attribute Values
        3.  
          Steps to Rename Duplicate Attributes
        4.  
          Best Practice for Attributes in Multi-Tenancy Environments
    5. Data Collector upgrades
      1.  
        Mandatory prerequisites
    6.  
      Troubleshoot - Downgrade of Data Collector is not supported
    7.  
      Troubleshoot - Manual Data Collector upgrades
    8.  
      Troubleshoot Data Collector upgrade manager upgrade failure and collector bundle download failure on Linux
    9.  
      Collector updates from the IT Analytics Portal
  4. Upgrade and Migrate to a new server
    1. Upgrade and migrate to a new server
      1.  
        Install the latest release of IT Analytics on the new server
      2.  
        Perform an export of the database on the existing server
      3.  
        Stop Portal and agent services on the new server
      4.  
        Drop and re-create the existing portal user on the new server
      5.  
        Import the database onto the new server
      6.  
        Start Portal and agent services on the new server
      7.  
        Download, install, and execute to upgrade the database schema
    2.  
      Testing
    3.  
      Update Data Collector binaries (if necessary)
  5. Appendix A. X Virtual Frame Buffer
    1.  
      Configure X Virtual Frame Buffer (Xvfb)
  6. Appendix B. Oracle patches for the database server
    1.  
      Install Oracle 19c Linux July 2025 patch

Troubleshoot - Manual Data Collector upgrades

If the Data Collector fails after completing the previous requirements and prerequisites, perform the following:

On the Collector Server:

  1. Kill all running IT Analytics-related Java processes.

  2. Start the Agent Service

  3. If the APTARE Agent Service does not continue to run, verify no IT Analytics-related Java processes are running. If required, kill all running IT Analytics-related Java processes.

    • Restart the Collector Server, if the Java processes cannot be killed manually. Prior to restarting the server, disable the automatic start of the APTARE Agent Service.

  4. Rename <APTARE_HOME>/java to java.old.

  5. Copy <APTARE_HOME>/upgrade/staging/snapshot/java to <APTARE_HOME>/

  6. Enable the automatic start of Agent service, if you previously disabled the service.

  7. Start the Agent Service.

    See Collector updates from the IT Analytics Portal.