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)

Task 5: Installing the database schema (Linux)

System: Database Server

This section covers the creation of the APTARE IT Analytics database. Follow these steps on the same server you installed the Oracle application binaries.

Note:

This step is required only if you have not opted to run create_aptare_database.shcreate_itanalytics_database.sh as a part of the aptareInstaller.sh script.

  1. Log in as aptare to your APTARE IT Analytics Database server.

    You must be logged in as a database user. If you already are logged in as root: su - aptare

  2. Run the APTARE IT Analytics database installation script to install the APTARE IT Analytics database objects and schema:

    /mnt/diska/create_aptare_database.sh

    Note:

    The following dialog will only appear if you are re-installing the APTARE IT Analytics database (e.g., after a failed attempt)

    The installer launches and prompts you to enter the domain name:

    Please enter your APTARE IT Analytics Portal Domain Name: (mycompany.com)
    You entered the following for your APTARE IT Analytics domain name:
    yourcompany.com
    Your APTARE IT Analytics Super User Login Account will be admin@yourcompany.com
    Is this the correct domain name (y/n)? y
    
  3. Database files will be extracted and the database schema will be created. This step will take between 5 - 10 minutes to complete.

  4. Next, the installer will load the database with Oracle packages. This step will take between 30 - 60 minutes to complete, depending on your system performance.

  5. The Portal user and the database schema are now created. During this step Oracle may produce messages similar to the following:

    mv: cannot stat `/opt/aptare/oracle/lib/EVENT_PACKAGE__PORTAL__2.so': No such file or directory

    Note:

    These messages can be ignored. Any other exceptions or errors however indicate a potential issue with the installation.

    Creating APTARE IT Analytics Portal user ...
    Completed creation of the APTARE IT Analytics Portal database user
    Creating APTARE IT Analytics database schema tables ...
    ...
    ... (EACH STEP LOGS TO THE CONSOLE...)
    ...
    Completed creation of the APTARE IT Analytics base schema tables
    Creating APTARE IT Analytics <backup product> schema tables ...
    
  6. The Packages are now validated:

    If you do not see the message "Successfully validated ALL Packages" at the end of this step, there is a possible problem with the install and you should save a copy of the installer log and contact the Veritas Support.

    Validating APTARE IT Analytics Packages...
    Validating PACKAGE ADAPTOR_PACKAGE
    Validating PACKAGE ADMINREP_PACKAGE
    Validating PACKAGE ALL_ERROR_PKG
    ...
    ... (EACH PACKAGE IS LOGGED TO THE CONSOLE...)
    ...
    Validating PACKAGE XML_REPORT_PKG
    Package specifications have successfully been validated
    ...
    Successfully validated ALL Packages.
    
  7. The database creation is now complete.

    Creation of APTARE IT Analytics Database completed at 
    Nov 11 18:31:46 PDT 2021
    A complete log of this session can be found in the file: 
    /opt/aptare/logs/install/create_aptare_database-xxxxx-xxxxx.log
    

    Note:

    If the installer reports errors during the install and you are unable to resolve the problem, you should save a copy of the installer log and contact the Veritas Support.

    If you do not have a APTARE IT Analytics license, you can install a trial license which is valid for 60 days with the this command as a root user:

    /opt/aptare/utils/installlicenseUI.sh /mnt/diska/license.slf /opt/aptare/utils/installlicenseUI.sh /mnt/portal/license.slf

  8. Installation of the Database components is now complete.

    The APTARE IT Analytics database is a container database with the pluggable database SCDB attached to it. The data files for the tablespaces are stored in the /data01-06/oradata/scdbpdb directory.

    Continue to the next section for the final step--License Key file installation.