Skip to content

opennetworkinglab/aether-ueransim

Folders and files

NameName
Last commit message
Last commit date

Latest commit

832e937 · Jan 3, 2025

History

58 Commits
Jan 3, 2025
Jan 3, 2025
Mar 21, 2024
Jan 3, 2025
Oct 16, 2023
Sep 30, 2024
Apr 29, 2024
Oct 16, 2023
Apr 2, 2024
Oct 16, 2023
Oct 17, 2024

Repository files navigation

ueransim

This blueprint runs UERANSIM in place of gNBsim, providing a second way to direct workload at SD-Core. Of particular note, UERANSIM runs iperf3, making it possible to measure UPF throughput. (In contrast, gNBsim primarily stresses the Core's Control Plane.)

The UERANSIM blueprint includes the following:

Global vars file "vars/main-ueransim.yml" gives the overall blueprint specification.

Step-by-Step Installation

To install ueransim, follow these steps:

  1. Inventory file hosts.ini needs to be modified to identify the server that is to run UERANSIM. Currently, a second server is needed, as UERANSIM and SD-Core cannot be deployed on the same server.
[ueransim_nodes]
node2
  1. Install the UERANSIM
    • Update the config files under configs directory for both UE and gNB.
    • Run make aether-ueransim-install.
  2. Start the simulation
    • Set "amf.ip" to the IP address of the core machine.
    • Run make aether-ueransim-run.

One-Step Installation

To install ueransim in one go, run make aether-ueransim-install.

Uninstall

To uninstall ueransim, run make aether-ueransim-uninstall.