APTARE IT Analytics Installation and Upgrade Guide for Linux

Last Published:
Product(s): APTARE IT Analytics (10.5)
  1. Install the APTARE IT Analytics Portal on a Linux server
    1.  
      Introduction
    2.  
      Portal installation memory requirements
    3.  
      OVA-based deployment on VMware ESXi
    4. Installer-based deployment
      1.  
        Task 1: Portal and database deployment strategies (Linux)
      2.  
        Task 2: Pre-installation configuration (Linux)
      3.  
        Task 3: Install Oracle database application binaries (Linux)
      4.  
        Task 4: Install the Portal application binaries (Linux)
      5.  
        Task 5: Installing the database schema (Linux)
      6.  
        Task 6: Start the Portal services (Linux)
      7.  
        Task 7: Request the license key file (Linux)
      8.  
        Task 8: Log into the Portal
      9.  
        Task 9: Install the license key file (Linux)
      10.  
        Task 10: Performing a cold backup of the database (Linux)
      11.  
        Recommended database backup process
    5.  
      Supported third-party and open source products
    6.  
      Uninstall the APTARE IT Analytics Portal
  2. Upgrade APTARE IT Analytics Portal on Linux
    1.  
      Overview
    2.  
      Upgrade path
    3.  
      Before upgrading
    4. Upgrade Oracle database application binaries to 19c (Linux)
      1.  
        Upgrade Oracle database application binaries (Linux)
    5. Upgrade APTARE 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
      8.  
        Upgrade the Portal with additional licensed modules
      9.  
        Upgrade scenarios
      10.  
        Database table creation scripts
      11. Add additional products
        1.  
          Prerequisites
      12.  
        Enable new features and report templates using the Portal
    6. Data Collector upgrades
      1.  
        Mandatory prerequisites
    7.  
      Troubleshoot - Manual Data Collector upgrades
    8.  
      Collector updates from the APTARE IT Analytics Portal
  3. Oracle patches for the database server
    1.  
      Apply Oracle-recommended patches
  4. Upgrade and Migrate to a new server
    1. Upgrade and migrate to a new server
      1.  
        Install the latest release of APTARE 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. Portal upgrades (Linux): Tomcat and Apache
    1.  
      Overview
    2.  
      Upgrade to Tomcat 8.5.56 from a previous Tomcat version
    3.  
      Upgrade the Apache Web Server to 2.4.xx (Linux)

Before upgrading

  • Ensure that you have a valid system backup. For additional information refer to the System Administrator Guide. Prior to executing the upgrade utility:

    • A cold backup of the Portal / Database server(s) file systems.

    • A backup of the file systems containing the Oracle database (typically /data01-06 on Linux) is only valid if it was taken while Oracle was completely shut down.

    • An export of the database.

  • If you have installed any patches on your present APTARE IT Analytics version, check the Release Notes to verify that they are included in this release. If you are uncertain, check with the Veritas Support. In most cases, previously installed patches are included in this release.

  • Verify that the libXtst.so.6 libraries are installed.

  • Verify the rpm fontconfig is installed. Fontconfig is a library designed to provide system-wide font configuration, customization and application access. If the rpm fontconfig is not installed, the installer will not be able to load in the console or silent mode. This is a prerequisite for a Linux Portal upgrade and a Data Collector installation.

  • In the Portal, verify that the Data Collectors are set for automatic updates. This setting triggers the automatic download of updated application logic to the Data Collectors in your enterprise. This download is required to ensure the Data Collectors are running with the latest compatible version. Refer to the vendor-specific Data Collector Installation Guide for additional information about Data Collectors.

    See Data Collector upgrades.

  • The Portal and Database components should be installed on the same server.

  • Identify the Java Version on the Data Collector Server and ensure that a 64-bit server is used for the Data Collector Server.

  • Beginning with release version 10.x.xx, Portal upgrades automatically enable privileges for newly added reports and certain features/functions, for all Administrators. This does not impact previously configured privileges. The Super User can manually revoke any Administrator privileges that have been automatically enabled.

  • Before upgrading to 10.6 or later for the first time, generate a new Veritas license with .slf extension having equal or more entitlement than the currently installed license. This license file will be required during the upgrade.

  • If upgrading to version 10.5 in a Shared Service environment, an additional database privilege should be provided using the following command.

    su - aptare

    sqlplus / as sysdba

    alter session set container = scdb; or APTARE database Service name if not 'scdb'

    GRANT EXECUTE ON DBMS_CRYPTO TO PORTAL;

    Note:

    Not providing the privilege on a limited access environment can cause upgrade failure.