Single-VM

This article describes the infrastructure requirements for deploying OvalEdge in a Proof of Concept (POC) environment. It defines the virtual machine specifications, network and port requirements, supported software versions, and required deployment artifacts.

Use this article to prepare the environment before installing the OvalEdge application and related services.

Scope

This article covers the following areas:

• Virtual machine specifications

• Network and port requirements

• Software versions and dependencies

• Deployment artifacts and ownership

Virtual Machine Specifications

OvalEdge requires two virtual machines for optimal performance and logical separation of services:

• VM1 hosts the OvalEdge application, ElasticSearch, and AskEdgi services.

• VM2 hosts the MySQL database.

Recommended VM Configuration

Service Type	Ram	vCPU	Storage (SSD)
VM1 (OvalEdge + ElasticSearch + AskEdgi)	32 GB	8	200 GB
VM2 (Database)	32 GB	8	200 GB

These specifications are recommended for a POC environment. Production environments may require higher capacity based on metadata volume, connector usage, and lineage processing.

Network and Port Requirements

Database Connectivity

Allow VM1 (OvalEdge application + Elastic Search) to communicate with VM2 (MySQL database) using the following port:

• Port: 3306 (MySQL)

Network Configuration Guidelines

• Whitelist the IP addresses of VM1 and VM2 on both servers.

• Ensure bi-directional network access between the virtual machines.

• Verify that no firewall or security group rules block database connectivity.

Software Specifications and Supported Versions

Install and configure the following software versions before deploying OvalEdge:

Component	Supported Version
Operating System	Ubuntu 24.04
MySQL	8.4.x
OvalEdge Application	Latest supported version
Apache Tomcat	10.1.41
ElasticSearch	7.17.18
Java	OpenJDK 17
Python	3.13.x
Poetry	2.1.2

Important: Use only the supported versions listed above to avoid compatibility issues with metadata ingestion, lineage processing, and stewardship workflows.

Deployment Artifacts

Artifacts Provided by OvalEdge

The OvalEdge team provides the following artifacts required for deployment:

• OvalEdge application WAR file

• MasterScripts for initial database schema setup

• License key

• Crontab configuration for cleaning temporary and cached files

Artifacts Provided by the Customer

The customer must provide the following:

• SSL certificate bound to the domain used for the OvalEdge application

Attach the SSL certificate to enable HTTPS access and secure communication between users and the OvalEdge platform.

Network Architecture

The following diagram represents the high-level network architecture for the OvalEdge POC deployment.

Conclusion

This article outlines the infrastructure, network, software, and artifact prerequisites for deploying OvalEdge in a POC environment. Completing these requirements ensures a stable and secure foundation for OvalEdge installation and operation.

---

Copyright © 2026, OvalEdge LLC, Peachtree Corners, GA, USA.