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.
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
Add Required Repositories.
Verify Existing Python Version.
If the version is below 3.13.x, install Python 3.13:
Sample Reference Screenshot:

Configure Python Alternatives.
Sample Reference Screenshot:

Verify Python Version.
There are two alternatives: python3 (providing /usr/bin/python3).
*0
/usr/bin/python3.10
1
auto mode
1
/usr/bin/python3.10
1
manual mode
2
/usr/bin/python3.13
2
manual mode
Poetry Installation (Version 2.1.3)
Run the following commands.
Directory Preparation
Create separate directories for the Edgi services (edgi_data and edgi_insight):
Sample Reference Screenshot:

Edgi Data Service Deployment
Create Required Directories.
Sample Reference screenshot:

Configure Environment Variables.
Edit the .env file:
Sample Reference screenshot:

Download and Extract Package.
Download the Edgi Data Service package (provided by DevOps) and extract it:
Sample Reference Screenshots:



Install Dependencies.
Run the following command from the directory containing pyproject.toml:
Sample Reference Screenshots:


Validate Service Startup.
Sample Reference Screenshot:

Verify that the service starts successfully, then stop it using Ctrl+C.
Configure systemd Service
Identify the Poetry binary path:
Sample Reference Screenshot:

Create the service file:
Manage the Service.
Service Management Commands
Reload Service
systemctl daemon-reload
Start Service
systemctl start data.service
Enable Service
systemctl enable data.service
Check Status
systemctl status data.service
Edgi Insight Service Deployment
Create Required Directories.
Sample Reference Screenshot:

Configure Environment Variables.
Sample Reference Screenshot:

Install and Validate.
Stop the service using Ctrl+C after validation.
Configure systemd Service.
Manage the Service.
OvalEdge Configuration Updates
Oasis Configuration
Update the following properties in the oasis configuration file:
Sample Reference Screenshot:

Restart Tomcat after saving the changes.
OvalEdge UI Configuration
Log in to the OvalEdge application.
Validate the MySQL connector (ID: -1) and complete crawl and profiling.


Navigate to System Settings → AI and update the following settings:
askedgi.edition = metadata analytics
Askedgiplus.enable = true
askedgi.ovaledge.recipe.connection.id = -1 (MySQL connector ID)

Update ai.config with the key provided by the DevOps team.

Log out and log back in to apply the changes.
Validation
Navigate to the AskEdgi feature.
Wait for workspace initialization.

Open the catalog and add a schema.


Verify data access.

Use the search bar to query metadata and validate results.
Successful responses confirm that the deployment is complete.
Copyright © 2026, OvalEdge LLC, Peachtree Corners, GA, USA.
Last updated
Was this helpful?

