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)

OVA-based deployment on VMware ESXi

Note:

This OVA is supported with VMware ESXi 6.5 and above only. The OVA comes with CentOS operating System with 300GB storage and 32GB RAM.

Steps to deploy

  1. Download the OVA from Download Centre : https://www.veritas.com/content/support/en_US/downloads.
  2. Deploy OVA on vCenter using Deploy OVF Template option.
  3. Login to VMware vCenter and select Deploy OVF Template.
  4. Select a name and the Folder. Click NEXT to navigate to the next page.
  5. Review the details and click NEXT.
  6. Select storage. To avoid getting any error, ensure that you select a Datastore that Host has access to. Click NEXT to navigate to the next page.
  7. Select the network and click NEXT.
  8. Customize Network parameters for VM by providing Hostname, Domainname, IP, Netmak, gateway, and DNS details.
  9. Click FINISH to complete the process.

Portal will be accessible with URL http://aptareportal.<domainname> with default login credentials as follows:

Username: admin@<domainname>

Password: P@ssw0rd

You can login to the Virtual machine created from OVA with the following credentials:

Username: admin

Password: P@ssw0_rd

To get root privileges type # sudo bash and use P@ssw0_rd as password.

It is strongly recommended that you change default password for admin and root users.

After VM bootup, the APTARE IT Analytics Portal will be re-configured with the user provided parameters for hostname, domainname and network parameters. In case of any issues while logging in to the portal, check the log file /opt/aptare/logs/boot-time-reconfig.log and the status of systemctl service aptare-init.service. The log file will have an error statement and steps to resolve the issue.