openairinterface5g/doc/NR_SA_Tutorial_OAI_CN5G.md

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
  • CPU: 8 cores x86_64 @ 3.5 GHz
  • RAM: 32 GB

2. OAI CN5G

2.1 OAI CN5G pre-requisites

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:

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

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

cd ~/oai-cn5g
docker compose up -d

3.2 Stop OAI CN5G

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

4.2 Testing with OAI nrUE

Please check this link: Testing with OAI gNB and OAI nrUE