Skip to content

Latest commit

 

History

History
46 lines (35 loc) · 3.96 KB

README.md

File metadata and controls

46 lines (35 loc) · 3.96 KB

OpenAirInterface Testbed

This testbed deployment consists of a 5G Core Network by Open5GS [1], gNodeB and 5G UE by OpenAirInterface [2], and FlexRIC by Mosaic5G [3].

Usage

  • Installation: Use ./full_install.sh to build and install the testbed components, and ./full_uninstall.sh to remove them.
  • Generate Configurations: Use ./generate_configurations.sh to create configuration files for each testbed component.
  • Start the Testbed: Use ./run.sh to start the 5G Core, FlexRIC, gNodeB, and UE as background processes, and KPI monitoring xApp in the foreground.
    • To start the testbed components but use a modified KPI monitor xApp that logs the metrics to file and a Grafana dashboard to fetch and visualize the metrics in real-time, use ./run_with_grafana_dashboard.sh.
  • Run an xApp: Once all components are running and properly connected, use the ./run_xapp_* scripts within the RAN_Intelligent_Controllers/FlexRIC/additional_scripts directory to interact with the gNodeB and UE.
  • Stop the Testbed: Terminate the testbed components with ./stop.sh.
  • Status: Check which testbed components are running with ./is_running.sh.
  • Debugging Information: Configuration files are in the configs/ directory, and log files are located in the logs/ directory for each component.

Potential Cause for Build Errors

It may be required for the AVX2 instruction set to be available on the host machine installing the OpenAirInterface testbed.

Enabling VT-x/AMD-V for the AVX2 instruction set
When running a VM to build OpenAirInterface5G, compilation errors may occur if not using VT-x/AMD-V due to an unsupported AVX2 instruction set. In VirtualBox, the lower right corner will show a "V" icon if using VT-x/AMD-V, otherwise, it will show a turtle icon. Additionally, AVX2 support can be verified by checking that `cat /proc/cpuinfo | grep avx2` is not empty. The following steps can be taken to ensure that VT-x/AMD-V is enabled in a VirtualBox VM.
  • CPU Virtualization Support: Look up if the CPU model supports virtualization and ensure that it is enabled in the BIOS.
  • Disable Hyper-V: Hyper-V may prevent VT-x/AMD-V from being enabled. If using Windows, the following options should be unchecked in the "Turn Windows features on or off" settings: "Hyper-V", "Windows Hypervisor Platform", and "Virtual Machine Platform". If a change is made, a reboot is required.
  • VirtualBox: From the VirtualBox Manager, select the VM and click the "Information" tab. Look for "Acceleration: VT-x/AMD-V".
    • If the VM shows this but the AVX2 instruction set is still disabled, then disabling core isolation is a potential reason. Please exercise extreme caution as it is not advised to disable core isolation. However, it can be disabled in the "Windows Security" settings by unchecking "Memory Integrity" and rebooting.
  • If cat /proc/cpuinfo | grep avx2 is not empty, then OpenAirInterface should be able to build without issues.

References

  1. Open Source implementation for 5G Core and EPC. Open5GS. https://github.com/open5gs/open5gs
  2. Openairinterface 5G Wireless Implementation. OpenAirInterface. https://gitlab.eurecom.fr/oai/openairinterface5g
  3. Flexible RAN Intelligent Controller (FlexRIC) and E2 Agent. Mosaic5G. https://gitlab.eurecom.fr/mosaic5g/flexric