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

Run the upgrade utility installer (Linux)

The absolute install path of Portal is represented as <install_path>. Substitute <install_path> with the absolute path of the Portal installation as applicable. If the Portal is installed on the default path, substitute by /opt which is the default path.

If you have configured a custom OS user or a group for Oracle or portal, instead of the default users or groups:

  • Update the OS user and group details in the environment file /<install_path>/aptare/bin/aptare_env.sh.

  • Ensure environment variables for Oracle, such as ORACLE_HOME, ORACLE_SID, PATH, LD_LIBRARY_PATH are set appropriately in /<install_path>/aptare/bin/aptare_env.sh and are exported correctly.

  • Update /<install_path>/aptare/upgrade/ant/sc_upgrade.xml with appropriate values for the custom OS user or group for Oracle and portal.

If you have the portal running with shared services and Oracle parameters such as service name and port are different than the default configuration, the upgrade utility installer will detect the parameters from the portal configuration file.

The following instructions assume you have the specific upgrade installer file for just your platform. You must perform these steps as a root user on the Linux system.

To mount the utility installer ISO:

  1. Mount the ISO image that you have downloaded on the server by entering the following commands. Replace xxxx with the relevant ISO file name.
    mkdir /mnt/diska
mount -o loop <sc_upgrader_xxxx_linux.iso> /mnt/diska
    mkdir /mnt/diska
mount -o loop <itanalytics_upgrader_xxxx_linux.iso> /mnt/diska

    Note:

    The portal upgrader prompts you that a mandatory cold backup is required and you are required to acknowledge that it was completed before your proceed.

    Example message:

    **************************************************************************
IT Analytics Upgrade Utility Installer 11.7.00
**************************************************************************
Revision 11.7.00.20250827161815 build 08272025-1233

To use this software you must agree to the following terms and conditions.
Enter "accept" to accept these Terms and Conditions: accept
**************************************************************************

 

Before Upgrading IT Analytics: Mandatory cold (file system) backup
**************************************************************************

To prevent data loss in the event of unexpected issues during the upgrade, you must create a recent cold (file system) backup of the IT Analytics application and its database.

Steps to Perform a Cold Backup:

   1. Shutdown IT Analytics application
   2. Back up the file system and Oracle data files using your preferred backup software or the cp command.

     NOTE:
     By default, IT Analytics files are located in the following directories on Linux:
     /opt, /data01, /data02, /data03, /data04, /data05 and /data06.

For detailed instructions on backup and restores procedures, refer to the IT Analytics System Administrator Guide (see the section: Backing up and restoring data).
**************************************************************************

Ready to Proceed?

If you have completed the cold backup and are ready to continue with the upgrade, type: PROCEED
If you have not completed the backup or wish to exit, type: EXIT

Proceed with IT Analytics Upgrade:  (PROCEED/EXIT)
  2. Run the installer with the following commands:
    cd /
/mnt/diska/portal_upgrader.sh

    Caution:

    IT Analytics no longer supports data collection from Compute Resources policy and NetBackup Resources Monitor probe of the NetBackup policy. Existing policies and scheduled probes will be removed with this upgrade. Previously collected data will be retained in the database. You can ignore this caution if you have not configured the Compute Resource policy or the Resource Monitor probe in your older version.

  3. Follow the instructions to complete the installation.