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 Windows

Last Published:
Product(s): NetBackup IT Analytics (11.7)
  1. Installation overview
    1.  
      IT Analytics components
    2.  
      Standard or Shared Services licensing edition
    3.  
      Install options
    4.  
      Multi-language support and locale considerations (Windows)
    5.  
      Third-party and open source products used
  2. Install IT Analytics on a Windows server
    1.  
      Step-1: Get the IT Analytics license key file
    2.  
      Step-2: Portal and database deployment strategies
    3.  
      Step-3: Pre-installation configuration
    4. Step-4: Installing Oracle application binaries
      1.  
        Troubleshoot the Oracle installation
    5.  
      Step-5: Installing Portal application binaries
    6.  
      Step-6: Log into the Portal
    7.  
      Step-7: Install the license key file
    8. Verify the current license configuration
      1.  
        Run the License Summary report
      2.  
        About IT Analytics version and license
      3.  
        View License Details
    9. Next steps
      1.  
        Performing a cold backup of the database
      2.  
        Recommended database backup process
  3. Upgrade IT Analytics Portal on Windows
    1.  
      Overview
    2.  
      Upgrade path
    3.  
      Before upgrading
    4. Upgrade IT Analytics Portal
      1.  
        Upgrading a shared services environment
      2.  
        Run the upgrade utility installer (Windows)
      3.  
        Running the upgrade utility
      4. Attribute merging during the Portal upgrade
        1.  
          Attribute management during the Portal upgrade
    5.  
      Data Collector upgrades
    6.  
      Troubleshooting - manual Data Collector upgrades
    7.  
      Troubleshoot - Downgrade of Data Collector is not supported
    8.  
      Troubleshoot Data Collector upgrade manager upgrade failure and collector bundle download failure on Windows
    9.  
      Collector updates from the IT Analytics Portal
    10.  
      Upgrade methods to incorporate enterprise objects
  4. Oracle patches for the database server
    1.  
      Install Oracle 19c Windows October 2024 patch
  5. Upgrade and migrate to a new server
    1.  
      Upgrade and migrate to a new Windows server

Run the upgrade utility installer (Windows)

Before you run the upgrade utility installer:

  • Download the Upgrade Utility Installer ISO and copy it to the portal server.

  • Perform the upgrade as an Administrator user who is a member of the ORA_DBA group.

  • When upgrading to version 11.x.xx, the date format defaults to the Portal operating system locale, and ignores any previous configuration.

The following instructions assume you have the required upgrade installer file for your platform.

  1. Double-click the ISO file to mount and run Setup.exe.

  2. Follow the installer prompts to extract the upgrade files and utilities.

    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. If you have chosen to Run Later in the earlier steps, complete the upgrade process by running the upgrade utility located at:

    C:\opt\aptare\upgrade\upgrade.bat

Note:

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.

Troubleshooting Tips

On rare occasions after upgrading to version 11.7, IT Analytics may display an access denied error while starting the portal Tomcat or agent Tomcat service.

To resolve this access error:

  1. From the command prompt, run the script to delete the Portal and Tomcat services
    C:\opt\aptare\utils\removeportalservices.bat

    If the service delete fails, reboot the system and again try to delete the services.

  2. Install the Portal services.
    C:\opt\aptare\utils\setupPortalTomcatService.bat
C:\opt\aptare\utils\setupAgentTomcatService.bat
  3. Start the Portal Tomcat and Agent Tomcat services from the Service Panel.