APTARE IT Analytics Installation and Upgrade Guide for Linux

Last Published:
Product(s): APTARE IT Analytics (10.6)
  1. Install the APTARE IT Analytics Portal on a Linux server
    1.  
      Introduction
    2.  
      Portal installation memory requirements
    3.  
      Multi-language support and locale considerations (Linux)
    4.  
      OVA-based deployment on VMware ESXi
    5. 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
    6.  
      Supported third-party and open source products
    7.  
      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
    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
    2. Apply Oracle 19c July 2022 patch application on Linux
      1.  
        Pre-Install setup
      2.  
        OPatch installation steps
      3.  
        Installing the Oracle patch
      4.  
        Validate the Patch
      5.  
        Validating JDK version update
  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. Appendix A. X Virtual Frame Buffer
    1.  
      Configure X Virtual Frame Buffer (Xvfb)

Upgrade Oracle database application binaries to 19c (Linux)

Prerequisites for upgrading Oracle database application binaries (Linux)

  1. Verify that the necessary rpms exist on your system based on the OS.

    • For RHEL 8 and CENTOS 8, use the following command:

      rpm -q perl-TermReadKey perl-Data-Dumper binutils 
glibc libaio elfutils-libelf perl-Getopt-Long binutils  
gcc gcc-c++ glibc-devel ksh libaio-devel libgcc libstdc++ 
libstdc++-devel sysstat psmisc bc make libnsl.x86_64 
--qf '%{name}.%{arch}\n'|sort

      The command returns:

      bc.x86_64
binutils.x86_64
elfutils-libelf.x86_64
gcc-c++.x86_64
gcc.x86_64
glibc-devel.x86_64
glibc.x86_64
ksh.x86_64
libaio-devel.x86_64
libaio.x86_64
libgcc.x86_64
libnsl.x86_64
libstdc++-devel.x86_64
libstdc++.x86_64
make.x86_64
perl-Data-Dumper.x86_64
perl-Getopt-Long.noarch
perl-TermReadKey.x86_64
psmisc.x86_64
sysstat.x86_64

    • For RHEL 7 and CENTOS 7, use the following command:

      rpm -q perl-TermReadKey perl-Data-Dumper binutils 
glibc libaio elfutils-libelf perl-Getopt-Long 
compat-libcap1 compat-libstdc++-33 gcc gcc-c++ 
glibc-devel ksh libaio-devel libgcc libstdc++ 
libstdc++-devel sysstat psmisc bc make --qf 
'%{name}.%{arch}\n'|sort

      The command returns:

      bc.x86_64
binutils.x86_64
compat-libcap1.x86_64
compat-libstdc++-33.x86_64
elfutils-libelf.x86_64
gcc-c++.x86_64
gcc.x86_64
glibc-devel.x86_64
glibc.x86_64
ksh.x86_64
libaio-devel.x86_64
libaio.x86_64
libgcc.x86_64
libstdc++-devel.x86_64
libstdc++.x86_64
make.x86_64
perl-Data-Dumper.x86_64
perl-Getopt-Long.noarch
perl-TermReadKey.x86_64
psmisc.x86_64
sysstat.x86_64

    • For SUSE Linux Enterprise, use the following command:

      rpm -q bc 
binutils glibc glibc-devel libcap-ng-utils 
libcap-ng0 libcap-progs libcap1 libcap2 
libelf-devel libgcc_s1 libjpeg-turbo 
libjpeg62 libjpeg62-turbo libpcap1 libpcre1 
libpcre16-0 libpng16-16 libstdc++6 libtiff5 
libaio-devel libaio1 make mksh perl-Term-ReadKey pixz rdma-core 
smartmontools sysstat xz --qf '%{name}.%{arch}\n'|sort

      The command returns:

      bc.x86_64
binutils.x86_64
glibc-devel.x86_64
glibc.x86_64
libaio-devel.x86_64
libaio1.x86_64
libcap-ng-utils.x86_64
libcap-ng0.x86_64
libcap-progs.x86_64
libcap1.x86_64
libcap2.x86_64
libelf-devel.x86_64
libgcc_s1.x86_64
libjpeg-turbo.x86_64
libjpeg62-turbo.x86_64
libjpeg62.x86_64
libpcap1.x86_64
libpcre1.x86_64
libpcre16-0.x86_64
libpng16-16.x86_64
libstdc++6.x86_64
libtiff5.x86_64
make.x86_64
mksh.x86_64
perl-Term-ReadKey.x86_64
pixz.x86_64
rdma-core.x86_64
smartmontools.x86_64
sysstat.x86_64
xz.x86_64

  2. Ensure you do not have symbolic links to your Oracle database directories. Oracle upgrade will fail if the installer detects symbolic links to the database directories. You must recreate the directory objects instead of symbolic links for the upgrade to succeed.