Multi-VM (Ubuntu)

This article provides step-by-step instructions for the fresh deployment of the Edgi Data Service and Edgi Insight Service, along with the required configuration updates to the OvalEdge UI and Job Services, in a multi-VM Ubuntu environment.

Each Edgi service is implemented as a Python application managed using Poetry and integrated with an existing OvalEdge on-premises installation.

Purpose

The purpose of this article is to provide clear, structured guidance for the fresh deployment of the Edgi Data Service and Edgi Insight Service in a multi-VM Ubuntu environment.

It outlines the prerequisites, software dependencies, network and port configurations, installation steps, service setup, and validation procedures required to successfully integrate askEdgi with an existing OvalEdge on-premises installation.

Prerequisites

Before starting the installation, ensure the following:

System Access

• Ubuntu Linux (LTS recommended)

• User account with sudo privileges

Application Requirements

• OvalEdge application is installed and running in a multi-VM setup

• MySQL database is accessible

• Elasticsearch is installed and running

Software Requirements

The following software is required on the Edgi service VMs:

• Python 3.13.x

• Poetry 2.1.3

Do not remove or overwrite the system default Python version. Doing so may break system utilities and the apt package manager.

Network and Port Requirements

Open the following inbound ports to allow communication between OvalEdge and Edgi services.

Port	Service	Purpose
8001	Edgi Data Service	Communication between Edgi Data Service and OvalEdge
8000	Edgi Insight Service	Communication between Edgi Insight Service and OvalEdge
9200	Elasticsearch	Communication between Edgi services and Elasticsearch
3306	MySQL	Communication between Edgi services and MySQL

Firewall Rules

• Open ports 8000 and 8001 inbound on the Edgi VM security group, allowing access from OvalEdge VMs.

• Open port 9200 inbound on the Elasticsearch security group, allowing access from Edgi VMs.

• Open port 3306 inbound on the MySQL security group, allowing access from Edgi VMs.

Installation Steps

Python 3.13

1. Enable Required Repository

   sudo apt install software-properties-common -y
   sudo add-apt-repository ppa:deadsnakes/ppa -y
   sudo apt update

2. Check the existing Python version:

   python3 --version

3. If the version is below 3.13.x, install Python 3.13:

   sudo apt install -y python3.13

   Sample Reference Screenshot:

   
4. Configure alternatives (do not remove existing Python):

   sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.10 1
   sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.13 2
   sudo update-alternatives --config python3

5. Verify Python Version.

   python3 --version

   Sample Reference Screenshot:

   

There are two alternatives: python3 (providing /usr/bin/python3).

Selection	Path	Priority	Status
*0	/usr/bin/python3.10	1	auto mode
1	/usr/bin/python3.10	1	manual mode
2	/usr/bin/python3.13	2	manual mode