1.2 Prerequisites

Review the prerequisites to install and use AHF Fleet Insights on various supported platforms.

  • Minimum recommended system resources:
    • 4 Cores
    • 16 GB RAM
    • 4 GB disk space per registered cluster

    A dedicated server is not mandatory, but it would improve performance. Running other applications on the same server could cause interference and impact the performance.

  • Installing necessary software dependencies
    • Java

      Go to https://www.oracle.com/in/java/technologies/downloads/ and download Java (22 or above).

      For example:
      sudo yum install https://download.oracle.com/java/23/latest/jdk-23_linux-x64_bin.rpm
    • Instant client and SQL*Plus

      Go to https://www.oracle.com/in/database/technologies/instant-client/linux-x86-64-downloads.html and download the latest version of Basic and SQL*Plus packages for your operating system.

      For example if you are running Oracle Linux 8:
      sudo yum install https://download.oracle.com/otn_software/linux/instantclient/2340000/oracle-instantclient-basic-23.4.0.24.05-1.el8.x86_64.rpm
      sudo yum install https://download.oracle.com/otn_software/linux/instantclient/2340000/oracle-instantclient-sqlplus-23.4.0.24.05-1.el8.x86_64.rpm
      For example if you are running Oracle Linux 7:
      sudo yum install https://download.oracle.com/otn_software/linux/instantclient/2114000/oracle-instantclient-basic-21.14.0.0.0-1.x86_64.rpm
      sudo yum install https://download.oracle.com/otn_software/linux/instantclient/2114000/oracle-instantclient-sqlplus-21.14.0.0.0-1.x86_64.rpm
  • Additional mandatory software dependencies

    Note:

    Ensure that the following packages are included in your environment, as they are crucial for a successful installation and the smooth operation of the application.
    • sudo yum install cronie

      The command sudo yum install cronie installs the Cronie package, which provides the cron daemon on Linux. This daemon allows users to schedule automated tasks, or "cron jobs," to run at specified times, useful for routine maintenance, backups, and other recurring tasks.

    • sudo yum install iproute

      The command sudo yum install iproute installs the iproute package on Linux, which provides network management tools like ip. These tools are used to configure and control networking features such as IP addresses, routes, network interfaces, and traffic control, essential for network setup and troubleshooting.

    • sudo yum install hostname

      The command sudo yum install hostname installs the hostname package on Linux, which provides tools to view and set the system's hostname. This is essential for identifying the machine on a network, configuring network settings, and managing server or device names.

  • Fleet Insights Database Schema Owner:

    Create a database user dedicated for AHF Fleet Insights using the create_db_user.sql script. This script is included in the installer zip file. The default user name is AHFFI. Replace the password placeholder in the script with the actual password you want to set and grant the appropriate privileges.

    CREATE USER AHFFI IDENTIFIED BY <password> DEFAULT TABLESPACE <tablespace>;
    GRANT CREATE SESSION TO AHFFI;
    GRANT CONNECT, RESOURCE TO AHFFI;
    GRANT CREATE TABLE TO AHFFI;
    GRANT INSERT ANY TABLE TO AHFFI;
    alter user AHFFI quota unlimited on <tablespace>;

    For more information about updating the password, refer to ahffi.

  • Database connection string:

    A valid database connection string to connect to Oracle Database (minimum version 19c).

  • Nginx server port:

    The Nginx server is used to serve the application, and its port is configured during the AHF Fleet Insights installation. The application will run on the port you specify within the range of 1024 to 49151.

Note:

If Oracle Database 23ai is used as the infrastructure repository database, then it does not require an additional license. For more information, see Special License Rights in the Oracle Database Licensing Information User Manual. Oracle Database 23ai can be downloaded from https://www.oracle.com/uk/database/free/