# OAI Core Network Installation
###### tags: `Construction`


## Pre-requisites ##

The container images are built using `docker build` command on Ubuntu 18.04 host machine. The base image for all the containers is Ubuntu 18.04.

The requried softwares and their respected versions are listed below. To replicate the testbed use these versions.

| Software | Version |
|:-------------------------- |:----------------------------------------|
| docker engine | 19.03.6, build 369ce74a3c |
| docker-compose | 1.27.4, build 40524192 |
| Host operating system | Ubuntu 18.04.4 LTS |
| Container operating system | Ubuntu 18.04 |
| tshark | Minimum 3.4.4 (Git commit c33f6306cbb2) |
| wireshark | Minimum 3.4.4 (Git commit c33f6306cbb2) |

## Step 1. Install Docker related components

#### Install Docker

curl –fsSL https://get.docker.com | bash –s docker -–mirror Aliyun 
sudo usermod –a –G docker oai-5gc # put the user name here then you do not need execute docker in superuser

#### Sign up in dockerhub
https://hub.docker.com/.

#### Install docker-compose

sudo curl -L "https://github.com/docker/compose/releases/download/1.27.4/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
# Establish soft link
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose 

* Check the Python3 version should >=3.6

#### Download CN images (in superuser)

sudo docker login
sudo docker pull ubuntu:bionic
sudo docker pull mysql:5.7
sudo docker pull rdefosseoai/oai-amf:latest
sudo docker pull rdefosseoai/oai-nrf:latest
sudo docker pull rdefosseoai/oai-spgwu-tiny:latest
sudo docker pull rdefosseoai/oai-smf:latest
sudo docker pull rdefosseoai/oai-udr:latest
sudo docker pull rdefosseoai/oai-udm:latest
sudo docker pull rdefosseoai/oai-ausf:latest
sudo docker pull rdefosseoai/oai-upf-vpp:latest
sudo docker pull rdefosseoai/oai-nssf:latest

#### Rename CN images (in superuser) for simplify depolyment

sudo docker image tag rdefosseoai/oai-amf:latest oai-amf:latest
sudo docker image tag rdefosseoai/oai-nrf:latest oai-nrf:latest
sudo docker image tag rdefosseoai/oai-smf:latest oai-smf:latest
sudo docker image tag rdefosseoai/oai-spgwu-tiny:latest oai-spgwu-tiny:latest
sudo docker image tag rdefosseoai/oai-udr:latest oai-udr:latest
sudo docker image tag rdefosseoai/oai-udm:latest oai-udm:latest
sudo docker image tag rdefosseoai/oai-ausf:latest oai-ausf:latest
sudo docker image tag rdefosseoai/oai-upf-vpp:latest oai-upf-vpp:latest
sudo docker image tag rdefosseoai/oai-nssf:latest oai-nssf:latest
sudo docker logout

#### Download OAI CN source code

git clone --branch v1.3.0 https://gitlab.eurecom.fr/oai/cn5g/oai-cn5g-fed.git
cd oai-cn5g-fed
git checkout –f v1.3.0
./scripts/syncComponents.sh

#### Execute OAI CN

* You can choose which CN mode you want to build

python3 core-network.py –help 

* Configuration (For example in basic mode)
<font color=#FF0000> **!!! Modify PLMN MCC, MNC, TAC, nssai_sst, nssai_sd to match with gNB and UE conf** </font>

vim <your oai cn diectory>/docker-compose/docker-compose-basic-nrf.yaml

* Execute (For example in basic mode)

# Scenario 1 include Network Repository Function (NRF)
# python3 core-network.py --type start-basic --scenario 1
python3 ./core-network.py –type start basic –fqdn no –scenario 1

* Related Log

docker logs oai-amf 
docker logs oai-smf
docker logs oai-nrf
docker logs oai-spgwu

### NAS Procedure

* AMF Log & SMF Log to see mobility management & session management state

docker logs oai-amf
docker logs oai-smf

## Experiment Result
AMF 5GMM
SMF 5GSM