Skip to content

Prerequisites and assumptions

Read this section carefully and make sure you have everything that is needed.

Minimum hardware requirements

The following hardware requirements need to be met for the solution

HOST CPU RAM SPACE
QoS-agent 1 Memory footprint : 20 Mb
Recommended RAM : 40 Mb		 Image size on disk : 50 Mb
Recommended disk : 100 Mb
Reflector 1 Memory footprint : 10 Mb
Recommended RAM : 20 Mb		 Image size on disk : 40 Mb
Recommended disk : 50 Mb
Analyzer (small) 1 Memory footprint : 2.32 Gb
Recommended RAM : 4 Gb + 0.1 Gb by agent		 Image size on disk : 9.95 Gb
Recommended disk : 20 Gb
Analyzer (medium) 2 Memory footprint : 2.32 Gb
Recommended RAM : 8 Gb + 0.1 Gb by agent		 Image size on disk : 9.95 Gb
Recommended disk : 50 Gb
Note: The data generated by the Agent amounts to ~15MB per day.
This amount will be influenced by the agent configuration and the interval of the measurements.
Scale up the storage space of the Analyzer depending on how many agents you will run.

Analyzer configuration

  • Small configuration supports between 1 and 20 QoS-agents.
  • Medium configuration supports between 1 and 150 QoS-agents.
Note: Data is retained within the database for only 90 days on a rolling basis.

Compatible hosts

The solution can be deployed on a wide range of hardware platforms. The lists below include tested and supported host types for each component.

Customer Premise Equipment (CPE)

  • Cradlepoint CPE with NetCloud OS v7+ and an advanced plan for container support:
    • E3000, E300, R1900, and Smart Mobility R2105
  • Semtech (ex-Sierra Wireless): XR-60, XR-90
  • Ekinops: OneAccess 5G router, ONE-5G
  • Thundercomm: TurboX EB3, Edge box 5
  • Lanner Electronics: EDGE devices (e.g. LEC-7242)

QoS-agent and Reflector

Virtual machines

  • AWS: EC2 t3.nano
  • GCP: e2-micro
  • Azure: Standard_A1_v2
  • OVH: D2-2

Personal computers

  • Laptop with 8 GB RAM and Microsoft Windows 11 (with Docker Desktop, WSL, Ubuntu)
  • Mini-PC with Ubuntu v24+:
    • Kamrui models AM02 or GC3V using either Intel Celeron or AMD Athlon with 8 GB RAM

Server / bare metal server

  • Dell, HPE, Lenovo

Portable devices

  • Intelligent SFP
  • LatenceTech Intelligent SFP 1G Pro

Smartphones

  • Android v12+ mobile phones
  • iOS v14 or later iPhones

Analyzer

Virtual machines

  • AWS: EC2 t3.large or t3.xlarge
  • GCP: e2-standard-2
  • Azure: Standard_B2ms or Standard_B4ms
  • OVH: D2-8

Personal computers

  • Mini-PC with Ubuntu v20+:
    • Kamrui models AM02 or GC3V using either Intel Celeron or AMD Athlon with 8 GB RAM
  • Laptop with 16 GB RAM and Microsoft Windows 11 (with Docker Desktop, WSL, Ubuntu v20.x LTS)

Container platforms

  • Kubernetes or OpenShift environments

Reflector's host ports to be opened

The following ports need to be exposed on the host running the reflector docker:

Latency measurement Protocol Port(s)
ICMP ICMP Icmp ports
HTTP TCP 12080
HTTP with SSL TCP 12443
TCP TCP 12023
UDP UDP 12024
TWAMP TCP 12862
TWAMP UDP 12800 to 12819
Other measurements Protocol Port(s)
Traffic capacity TCP, UDP 12501
LIFBE TCP, UDP 12550
Packet Loss Test (udp) TCP, UDP 12555

Analyzer's host ports to be opened

The following ports need to be exposed on the host running the analyzer dockers:

Docker Protocol Port(s)
Kafka zookeeper TCP 12092
Grafana TCP 12021
Influx TCP 12086
API TCP 12099
MCP TCP 12098

Necessary packages

The following applications must be installed on all virtual machines hosting the solution.

OS Application Installation
Ubuntu/Debian wget sudo apt install -y wget

Docker Installation

Note: All those commands will need to be executed with root priviledges.

Update apt:

apt update -y

Add the Docker repositories:

apt install ca-certificates curl gnupg -y

install -m 0755 -d /etc/apt/keyrings

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
chmod a+r /etc/apt/keyrings/docker.gpg

echo \
    "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
    "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
    sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Update apt again:

apt update -y

Install the docker utilities:

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

Create a Docker group if none was created:

sudo groupadd docker

Add your user to the Docker group

sudo usermod -aG docker <user_name>

In order for the changes to take effect, you either need to close and open a new terminal or logout and login again into your account.

The Docker Version 2 will now be installed. The docker-compose command will now become docker compose (no dash in between), and this new command should be used during the installation of the Latencetech solution.