基于docker容器的，OAI 5G全栈部署方案 (OAI 5G核心网 + OAI 5G接入网 + OAI 5G终端 + RF模拟器)

本文描述的是OAI官方支持的独立接入部署方案，这是一个基于docker容器的，OAI 5G全栈部署方案。
在这个方案中，包含了OAI 5G核心网、OAI 5G接入网、OAI 5G终端和RF模拟器。完成此方案部署后，可以基于些方案进行5G端到端测试方案和各种场景的测试与研究。

一，部署准备：

• 已经正确安装ubuntu18.04或者更新的ubuntu系统
• 在系统上正确安装了docker和docker-compose
• 已经安装python3.9或以上版本
• 已经安装git软件
• ubuntu系统能正常访问网络

具体可以参照部署OAI软件前的准备工作一文。

二，部署示意图

如下图，本端到端的独立接入部署方案，主要由以下三大网元构成，每个网元由一个或者多个不同功能的子网元构成。

• OAI 5G 核心网
  • mysql
  • oai-nrf
  • oai-amf
  • oai-smf
  • oai-spgwu
  • oai-ext-dn
• OAI 5G 接入网基站
  • oai-gnb
• OAI 5G 终端
  • oai-nr-ue
    
    注意，这个部署方案中，我们使用了RF模拟器（以下称射频仿真器），RF模拟器是OAI 5G RAN项目的一个子项目，这个项目又称为L1仿真框架。这个项目是为了在没有射频卡的情况下进行功能测试，引入了射频仿真器， 射频仿真器使用基于TCP/IP的软件通信代替了射频卡。使得在没有实时时钟限制的情况下OAI 5G基站和OAI 用户终端可以通过射频接口相互通信。I/Q 采样数据可以通过一个无线信道模拟器进行传输。射频仿真器已经支持了多入多出技术(MIMO)。

三，下载或者编译各个网元的容器镜像docker images

各个网元的容器镜像docker images保存在docker hub网站上。

1. 登录docker-hub

sudo docker login

2. 下载各个网元的容器镜像docker images

sudo docker pull mysql:8.0
sudo docker pull oaisoftwarealliance/oai-amf:v1.5.0
sudo docker pull oaisoftwarealliance/oai-nrf:v1.5.0
sudo docker pull oaisoftwarealliance/oai-smf:v1.5.0
sudo docker pull oaisoftwarealliance/oai-spgwu-tiny:v1.5.0
sudo docker pull oaisoftwarealliance/trf-gen-cn5g:focal
sudo docker pull oaisoftwarealliance/oai-gnb:develop
sudo docker pull oaisoftwarealliance/oai-nr-ue:develop

3. 退出登录

sudo docker logout

四，下载部署用的配置与脚本文件

使用http或者git从oai官方代码托管网站下载penairinterface5g/ci-scripts整个目录以及目录下所有文件与目录。

五，部署OAI 5G核心网

注意 ，一定要进入/ci-scripts/yaml_files/5g_rfsimulator后才能开始部署，用docker-compose的以下命令部署后，直到打印出下列部署信息。稍等一会后，用docker-compose ps -a命令检查，如下图全部容易都进入healthy状态后说明核心网部署成功。

xxx@xxx-pc: cd ./ci-scripts/yaml_files/5g_rfsimulator
xxx@xxx-pc:~/ci-scripts/yaml_files/5g_rfsimulator$ sudo docker-compose up -d mysql oai-nrf oai-amf oai-smf oai-spgwu oai-ext-dn
Creating network "rfsim5g-oai-public-net" with driver "bridge"
Creating network "rfsim5g-oai-traffic-net" with driver "bridge"
Creating rfsim5g-oai-nrf ... done
Creating rfsim5g-mysql   ... done
Creating rfsim5g-oai-amf ... done
Creating rfsim5g-oai-smf ... done
Creating rfsim5g-oai-spgwu ... done
Creating rfsim5g-oai-ext-dn ... done

xxx@xxx-pc:~/ci-scripts/yaml_files/5g_rfsimulator$ sudo docker-compose ps -a
       Name                     Command                  State                  Ports            
-------------------------------------------------------------------------------------------------
rfsim5g-mysql        docker-entrypoint.sh mysqld      Up (healthy)   3306/tcp, 33060/tcp         
rfsim5g-oai-amf      python3 /openair-amf/bin/e ...   Up (healthy)   38412/sctp, 80/tcp, 9090/tcp
rfsim5g-oai-ext-dn   /bin/bash -c  iptables -t  ...   Up (healthy)                               
rfsim5g-oai-nrf      pytho