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)

Installing the Oracle patch

  1. As a root user, copy the Oracle patch file from /tmp to /opt/aptare/oracle folder using following command:
    mv p34133642_190000_Linux-x86-64.zip /opt/aptare/oracle
  2. su - aptare
  3. Navigate to /opt/aptare/oracle folder and unzip the file.
    cd /opt/aptare/oracle
    unzip p34133642_190000_Linux-x86-64.zip
    

    The above command will create a 34133642 folder in /opt/aptare/oracle folder

    During the unzip if you see the below message put 'y' as shown below.

    replace PatchSearch.xml? [y]es, [n]o, [A]ll, [N]one, [r]ename: y
  4. Set permission on patch folder 34133642
    chown -R aptare:dba 34133642

    Note:

    If you have already installed an Oracle patch previously, skip the following steps from 5 through 11.

  5. As root user copy the two jar files from /tmp to /opt/aptare/oracle/sqldeveloper/sqldeveloper/lib folder.
    mv xdb6.jar /opt/aptare/oracle/sqldeveloper/sqldeveloper/lib
    mv xmlparserv2-sans-jaxp-services.jar 
    /opt/aptare/oracle/sqldeveloper/sqldeveloper/lib
    
  6. Change permissions on the jar files and perl
    cd /opt/aptare/oracle/sqldeveloper/sqldeveloper/lib
    chown -R aptare:dba xdb6.jar
    chown -R aptare:dba xmlparserv2-sans-jaxp-services.jar
    cd /opt/aptare/oracle
    chown -R aptare:dba perl
    chmod -R 775 perl
    
  7. Check if oraInventory folder is available under /opt/. If the folder is not available, then
    cd /opt/aptare/upgrade
    cp oraInventory.zip /opt/
    unzip oraInventory
    
  8. Check permission on /opt/oraInventory folder if it is aptare:dba else change the permission
    cd /opt/
    chown -R aptare:dba oraInventory
    
  9. Execute su -aptare
  10. Execute the following command to attach the Oracle home
    $ORACLE_HOME/oui/bin/runInstaller -silent -ignoreSysPrereqs 
    -invPtrLoc "/opt/aptare/oracle/oraInst.loc" -attachHome 
    ORACLE_HOME="/opt/aptare/oracle" ORACLE_HOME_NAME="OraDB19c_home" 
    INVENTORY_LOCATION="/opt/oraInventory"

    Note:

    If the oracle home is already attached, Oracle Home already exists at this location. Select another location message is displayed. Ignore this message.

  11. Follow the steps to make changes for fuser if you see the fuser error 'Missing command :fuser'
    cd /opt/aptare/oracle/bin/
    touch fuser
    chmod 755 fuser
    
  12. Set PATH. Make sure you set all the paths else patch application might fail.
    export PATH=$PATH:/opt/aptare/oracle/OPatch
    export PATH=$PATH:/usr/ccs/bin
    PATH=$PATH:/opt/aptare/oracle/sqldeveloper/sqldeveloper/lib
    
  13. Check for any OPatch conflicts.
    cd /opt/aptare/oracle/34133642
    /opt/aptare/oracle/OPatch/opatch prereq CheckConflictAgainstOHWithDetail 
    -ph ./
    
  14. If no conflicts are detected, execute the following command to apply patch from /opt/aptare/oracle/34133642 folder.
    /opt/aptare/oracle/OPatch/opatch apply
    
    Verifying environment and performing prerequisite checks...
    OPatch continues with these patches:   34133642
    Do you want to proceed? [y|n]
    y
    Is the local system ready for patching? [y|n]
    y
    Patching component oracle.jdk, 1.8.0.201.0...
    
    Sub-set patch [33806152] has become inactive due to the application of a super-set patch [34133642].
    Please refer to Doc ID 2161861.1 for any possible further required actions.
    Log file location: /opt/aptare/oracle/cfgtoollogs/opatch/opatch2022-07-20_20-44-05PM_1.log
    OPatch succeeded.
    
  15. Verify OPatch succeeded with the following command:
    /opt/aptare/oracle/OPatch/opatch lsinventory -detail
  16. Connect to SQL Plus using following command:

    -bash-4.2$ sqlplus /nolog

    SQL*Plus: Release 19.0.0.0.0 - Production on Wed Jul 20 20:55:30 2022

    Version 19.16.0.0.0

    Copyright (c) 1982, 2022, Oracle. All rights reserved.

  17. Connect as sysdba

    SQL> connect / as sysdba

    Connected to an idle instance.

  18. Start the database.

    SQL> startup

    ORACLE instance started.

    :

    :

    Database mounted.

    Database opened.

  19. Open all pluggable database.

    SQL> alter pluggable database all open;

    Pluggable database altered.

  20. Exit from SQL prompt.

    SQL> quit

  21. Datapatch is run to complete the post-install SQL deployment for the patch being installed.

    Execute the following command to apply the patch to the pluggable database (This may take few minutes)

    /opt/aptare/oracle/OPatch/datapatch -verbose
    Patch installation complete.  Total patches installed: 3
    
    Validating logfiles...done
    
    Patch 34133642 apply (pdb CDB$ROOT): SUCCESS
      logfile: /opt/aptare/cfgtoollogs/sqlpatch/34133642/24865470/
    34133642_apply_SCDBCNTR_CDBROOT_2022Jul20_20_58_00.log (no errors)
    
    Patch 34133642 apply (pdb PDB$SEED): SUCCESS
      logfile: /opt/aptare/cfgtoollogs/sqlpatch/34133642/24865470/
    34133642_apply_SCDBCNTR_PDBSEED_2022Jul20_20_59_00.log (no errors)
    
    Patch 34133642 apply (pdb SCDB): SUCCESS
      logfile: /opt/aptare/cfgtoollogs/sqlpatch/34133642/24865470/
    34133642_apply_SCDBCNTR_SCDB_2022Jul20_20_59_00.log (no errors)
    SQL Patching tool complete on Wed Jul 20 21:00:09 2022
    
  22. Check the log files in /opt/aptare/cfgtoollogs/sqlpatch/ for errors. The log file name includes the current timestamp:

    Example:

    /opt/aptare/cfgtoollogs/sqlpatch/
    sqlpatch_17520_2022_07_20_20_57_17/sqlpatch_invocation.log
  23. Start all services as root user.
    /opt/aptare/bin/aptare start