APTARE IT Analytics Installation and Upgrade Guide for Windows

Last Published:
Product(s): APTARE IT Analytics (10.5)
  1. Install APTARE IT Analytics Portal on a Windows server
    1.  
      Introduction
    2.  
      Portal installation memory requirements
    3.  
      Task 1: Portal and database deployment strategies (Windows)
    4.  
      Task 2: Pre-installation configuration (Windows)
    5. Task 3: Installing Oracle application binaries (Windows)
      1.  
        Troubleshoot the Oracle installation
    6.  
      Task 4: Installing Portal application binaries (Windows)
    7.  
      Task 5: Request the license key file (Windows)
    8.  
      Task 6: Log into the Portal (Windows)
    9.  
      Task 7: Install the license key file (Windows)
    10.  
      Task 8: Performing a cold backup (Windows)
    11.  
      Supported third-party and open source products
    12.  
      Uninstall Portal server software
  2. Upgrade APTARE IT Analytics Portal on Windows
    1.  
      Overview
    2.  
      Upgrade path
    3.  
      Before upgrading
    4. Upgrade the Oracle database application binaries to19c (Windows)
      1.  
        Upgrading the Oracle database application binaries (Windows)
    5. Upgrade APTARE 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.  
        Upgrading the Portal with additional licensed modules
      6.  
        Database table creation scripts
      7.  
        Add additional products
      8.  
        Enable new features and report templates using the Portal
    6.  
      Data Collector upgrades
    7.  
      Troubleshooting - manual Data Collector upgrades
    8.  
      Collector updates from the APTARE IT Analytics Portal
    9.  
      Clustered NetBackup Upgrade Procedure
    10.  
      Upgrade methods to incorporate enterprise objects
  3. Oracle patches for the database server
    1.  
      Install Oracle 19c Windows July 2021 patch
  4. Upgrade and migrate to a new server
    1.  
      Upgrade and migrate to a new server
  5. Portal upgrades (Win): Tomcat and Apache
    1.  
      Overview
    2.  
      Upgrade from Tomcat 7 to Tomcat 8 (Win)
    3.  
      Upgrade the Apache Web Server to 2.4.xx to 2.4.yy (Windows)

Upgrade the Apache Web Server to 2.4.xx to 2.4.yy (Windows)

Prerequisite

Verify that the C++ Redistributable for Visual Studio 2015 is installed. If not, you can download the vc_redist.x64.exe from https://www.microsoft.com/en-us/download/details.aspx?id=48145 and install it before you attempt to upgrade Apache.

  1. Stop all services by running:

    C:\opt\aptare\utils\stopallservices.bat
  2. Remove Apache services by running:

    C:\opt\apache\bin\httpd -k uninstall -n "APTARE Apache"
  3. Log into Veritas Support to retrieve the distribution files that are used in these instructions.

  4. Download the latest binary apache.zip and following apache configuration files:

    • httpd.conf

    • httpd-aptare.conf

    • httpd-override.conf

    • httpd-ssl.conf

    • httpd-ssl-aptare.conf

    • httpd-ssl-override.conf

  5. Rename C:\opt\apache to C:\opt\apache-old

  6. Unzip apache.zip into C:\opt

    The new path should be: C:\opt\apache

  7. Copy worker.properties from c:\opt\apache_old\conf to c:\opt\apache\conf.

  8. Copy httpd.conf, httpd-aptare.conf, and httpd-override.conf files to C:\opt\apache\conf folder.

  9. Copy httpd-ssl.conf, httpd-ssl-aptare.conf and httpd-ssl-override.conf file in C:\opt\apache\conf\extra folder.

  10. Replace all occurrence of ~PORTAL_BASE~ in C:\opt\apache\conf\httpd.conf, C:\opt\apache\conf\httpd-aptare.conf and C:\opt\apache\conf\extra\httpd-ssl.conf with C:\opt\aptare.

  11. Replace all occurrence of ~DOMAIN_NAME~ in C:\opt\apache\conf\httpd.conf and C:\opt\apache\conf\extra\httpd-ssl.conf with domain name of portal.

  12. Add any custom setting that was added in C:\opt\apache\conf\httpd.conf in C:\opt\apache\conf\httpd-override.conf.

  13. Add any custom setting that was added in C:\opt\apache\conf\extra\httpd-ssl.conf in C:\opt\apache\conf\extra\httpd-ssl-override.conf.

  14. If the certificates and key files are located under C:\opt\apache-old\conf copy them to C:\opt\apache\conf

    Note:

    This is the default location. These files may be in a different custom location in your system. The location of the files will be indicated by httpd-ssl.conf.

  15. Verify Apache configurations by opening the command prompt and entering:

    > cd c:\opt\apache\bin
    
    > httpd.exe -t
  16. Install Apache Services by running:

    C:\opt\apache\bin\httpd -k install -n "APTARE Apache"

    If upgrading to Apache 2.4.33 or later comment out the following lines in httpd-ssl.conf with hash as follows:

    #SSLSessionCache        "shmcb:C:/opt/apache/logs/ssl_scache(512000)"
    #SSLSessionCacheTimeout  300
    #SSLMutex  default
    
  17. Start all services by running:

    C:\opt\aptare\utils\startallservices.bat