OAI 5G NR SA tutorial: setting up OAI CN5G

**Table of Contents** [[_TOC_]] # 1. Scenario In this tutorial we describe how to configure and run a 5G end-to-end setup with OAI CN5G, OAI gNB and COTS UE. Minimum hardware requirements: - Laptop/Desktop/Server for OAI CN5G and OAI gNB - Operating System: [Ubuntu 22.04 LTS](https://releases.ubuntu.com/22.04/ubuntu-22.04.1-desktop-amd64.iso) - CPU: 8 cores x86_64 @ 3.5 GHz - RAM: 32 GB # 2. OAI CN5G ## 2.1 OAI CN5G pre-requisites ```bash sudo apt install -y git net-tools putty sudo apt install -y apt-transport-https ca-certificates curl software-properties-common curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add - sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" sudo apt update sudo apt install -y docker docker-ce # Add your username to the docker group, otherwise you will have to run in sudo mode. sudo usermod -a -G docker $(whoami) reboot ``` ## 2.2 OAI CN5G configuration files Download and copy configuration files: ```bash wget -O ~/oai-cn5g.zip https://gitlab.eurecom.fr/oai/openairinterface5g/-/archive/develop/openairinterface5g-develop.zip?path=doc/tutorial_resources/oai-cn5g unzip ~/oai-cn5g.zip mv ~/openairinterface5g-develop-doc-tutorial_resources-oai-cn5g/doc/tutorial_resources/oai-cn5g ~/oai-cn5g rm -r ~/openairinterface5g-develop-doc-tutorial_resources-oai-cn5g ~/oai-cn5g.zip ``` ## 2.3 Pull OAI CN5G docker images ```bash docker pull mysql:8.0 docker pull oaisoftwarealliance/oai-amf:develop docker pull oaisoftwarealliance/oai-nrf:develop docker pull oaisoftwarealliance/oai-smf:develop docker pull oaisoftwarealliance/oai-udr:develop docker pull oaisoftwarealliance/oai-udm:develop docker pull oaisoftwarealliance/oai-ausf:develop docker pull oaisoftwarealliance/oai-spgwu-tiny:develop docker pull oaisoftwarealliance/trf-gen-cn5g:latest docker build --target ims --tag asterisk-ims:latest --file ~/oai-cn5g/Dockerfile . ``` # 3. Run OAI CN5G ## 3.1 Start OAI CN5G ```bash cd ~/oai-cn5g docker compose up -d ``` ## 3.2 Stop OAI CN5G ```bash cd ~/oai-cn5g docker compose down ``` # 4. Run 5G NR SA end-to-end setup with OAI gNB ## 4.1 Testing with COTS UE Please check this link: [Testing with OAI gNB and COTS UE](NR_SA_Tutorial_COTS_UE.md) ## 4.2 Testing with OAI nrUE Please check this link: [Testing with OAI gNB and OAI nrUE](NR_SA_Tutorial_OAI_nrUE.md)