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)

Task 2: Pre-installation configuration (Windows)

  1. Choose a Portal Server. For performance reasons, the APTARE IT Analytics Portal software should not be installed on the same server as the Data Collectors. If, for some reason, you require both to be on the same server, be sure that both the Portal and Data Collector software do not reside in the same directory on the server. Root privileges are required for the Portal software installation tasks.

    You will need to log in as a Local Administrator to perform the installation. Oracle requires that you are logged in as a Local Administrator. Logging in as a Domain Administrator is not sufficient for this installation. Refer to the Oracle web site for the requirement to install on Windows as a user who is a member of the server's local Administrator's group.

  2. Verify the OS of the Portal Server. Check that the OS is one of the certified operating systems listed in the Certified Configurations Guide.

  3. Verify the Third-Party Software list.

    See Supported third-party and open source products.

  4. Verify Microsoft Visual C++ Runtime libraries are installed.

    APTARE IT Analytics installs Apache HTTP Server which has a dependency on run-time components of Visual C++ libraries. These run-time components are included in the Microsoft Visual C++ 2015 Redistributable Update 3 RC. This Microsoft distribution is available for download from www.microsoft.com. If this redistributable update is not installed prior to running the APTARE IT Analytics installer, Apache HTTP Server will not be able to run.

    Note:

    If you installed Microsoft Visual C++ 2015 after APTARE IT Analytics 10.3.xx was installed, and services are failing, you must manually install the Apache service using the following command:

    C;\opt\apache\bin\httpd -k install -n "APTARE Apache"
  5. Verify that sufficient disk space exists on the designated Portal Server. For the database file systems, the amount specified is the minimum required to create the database. It is recommended that you allocate more than the minimum to accommodate growth.

    Directory

    Minimum Disk Space

    Notes

    C:\opt

    20 GiB

     

    C:\tmp

    10 GiB

     

    C:\oradata

    140 GiB

    The Installer prompts for the target drive for the oradata directory, so alternate drives are supported.

    Total

    170 GiB

    • Add aptareportal.yourdomain.com and aptareagent.yourdomain.comentries to your enterprise DNS Server. Both entries must resolve to the IP address of the Portal server. Also note that the last component of the domain must be one of the recognized root domains; for example, .com--not .3com.

  6. Verify that there are no other web servers--for example, IIS--running on the system.

  7. The installer will set up the following system-wide environment variables and update the PATH environment variable. following system environment variables:

    Variable Name

    Variable Value

    ORACLE_HOME

    C:\opt\oracle

    ORACLE_SID

    scdb

    The PATH environment variable will have the following path appended to the end of the current PATH:

    C:\opt\oracle\bin