https://github.com/opennetworkinglab/aether-ueransim
Aether UERANSIM
https://github.com/opennetworkinglab/aether-ueransim
Last synced: 4 months ago
JSON representation
Aether UERANSIM
- Host: GitHub
- URL: https://github.com/opennetworkinglab/aether-ueransim
- Owner: opennetworkinglab
- License: apache-2.0
- Created: 2023-10-09T21:15:17.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-05-30T23:10:10.000Z (about 1 year ago)
- Last Synced: 2025-06-14T14:44:18.532Z (12 months ago)
- Language: Makefile
- Size: 70.3 KB
- Stars: 1
- Watchers: 3
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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
```
2. Install the UERANSIM
- Update the config files under configs directory for both UE and gNB.
- Run `make aether-ueransim-install`.
3. 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`.