【OAI】Openairinterface从零开始搭建5G核心网——Basic版

1.安装虚拟机

虚拟机VMware ：16.2.0 build-18760230

百度网盘链接：
https://pan.baidu.com/s/1TfDdb4gczyURrrqAhqKO0Q?pwd=0518
提取码：0518

2. 安装Ubuntu

Ubuntu是常见的Linux平台之一，OAI目前的部署只支持Ubuntu

Ubuntu 18.04安装参考教程1
Ubuntu 18.04安装参考教程2

安装完后下载各种镜像的时候可能速度很慢，将下载源改为阿里或清华的镜像。
详见链接 :更换镜像下载源

3.安装VMware tools （可选）

VMware tools 可以实现主机与虚拟机之间文件的自由拖拽与文本复制粘贴等功能
安装vmwaretools
vmwaretools复制粘贴修复

以上为在Windows里部署OAI所需要的步骤，在原生Ubuntu18.4系统中，依照下面步骤同样可以搭建基础核心网

4.环境安装

4.1Docker与Docker-compose安装

1. 卸载旧版本Docker

#卸载旧版本docker
sudo apt-get remove docker docker-engine docker-ce docker.io	

#清空旧版docker占用的内存
sudo apt-get remove --auto-remove docker

#更新系统源
sudo apt-get update

2.配置安装环境

sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common

3. 添加阿里云的docker GPG密钥

curl -fsSL http://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo apt-key add -

4. 添加阿里镜像源

sudo add-apt-repository "deb [arch=amd64] http://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable"
#更新
sudo apt-get update

5. 查看有哪些版本

apt-cache madison docker-ce

6. 安装最新版/指定版本

#安装最新版
sudo apt-get install -y docker-ce
#安装5:19.03.6~3-0~ubuntu-bionic版
sudo apt-get install -y docker-ce=5:19.03.6~3-0~ubuntu-bionic

7. 重启Docker

sudo service docker restart
#或者
sudo systemctl restart docker

8. 查看Docke版本

sudo docker version

9. 运行hello-world验证docker-ce是否安装成功

sudo docker run hello-world

10. 安装docker-compose

#安装pip
sudo apt install python3-pip
#更新一下库
sudo apt-get update
#更新一下pip
sudo pip3 install --upgrade pip
#安装docker-compose
sudo pip3 install docker-compose

若有错误

就更新一下 six

pip3 install six --user -U

查看docker-compose版本

docker-compose --version

4.2安装python3 3.6.9版本

一般ubuntu自带安装了python3 3.6.9，可以进行查看

python3 -v

4.3下载所需镜像

1. 布置docker hub 下载环境

sudo usermod -a -G docker myusername
#username 改为主机虚拟机名字，位于@后的

然后需要一个docker hub 账号，可以去创建一个docker hub

$ sudo docker login

2. 下载所需环境镜像

$ docker pull ubuntu:bionic
$ docker pull mysql:5.7

3.下载部署核心网所需镜像

## 下载核心网镜像
 [官方构建核心网链接](https://gitlab.eurecom.fr/oai/cn5g/oai-cn5g-fed/-/blob/master/docs/DEPLOY_SA5G_MINI_DEPLOYMENT.md)
 
```bash
docker pull oaisoftwarealliance/oai-amf:v1.4.0
docker pull oaisoftwarealliance/oai-nrf:v1.4.0
docker pull oaisoftwarealliance/oai-spgwu-tiny:v1.4.0
docker pull oaisoftwarealliance/oai-smf:v1.4.0
docker pull oaisoftwarealliance/oai-udr:v1.4.0
docker pull oaisoftwarealliance/oai-udm:v1.4.0
docker pull oaisoftwarealliance/oai-ausf:v1.4.0
docker pull oaisoftwarealliance/oai-upf-vpp:v1.4.0
docker pull oaisoftwarealliance/oai-nssf:v1.4.0
# Utility image to generate traffic
docker pull oaisoftwarealliance/trf-gen-cn5g:latest

下载前需登陆 docker，下载过程可能有些慢，可换不同的源尝试，或试一下阿里的源加速链接: 使用阿里源加速docker pull
参考链接
有时候不管怎么改都很慢，待解决

然后修改tag

docker image tag oaisoftwarealliance/oai-amf:v1.4.0 oai-amf:v1.4.0
docker image tag oaisoftwarealliance/oai-nrf:v1.4.0 oai-nrf:v1.4.0
docker image tag oaisoftwarealliance/oai-smf:v1.4.0 oai-smf:v1.4.0
docker image tag oaisoftwarealliance/oai-spgwu-tiny:v1.4.0 oai-spgwu-tiny:v1.4.0
docker image tag oaisoftwarealliance/oai-udr:v1.4.0 oai-udr:v1.4.0
docker image tag oaisoftwarealliance/oai-udm:v1.4.0 oai-udm:v1.4.0
docker image tag oaisoftwarealliance/oai-ausf:v1.4.0 oai-ausf:v1.4.0
docker image tag oaisoftwarealliance/oai-upf-vpp:v1.4.0 oai-upf-vpp:v1.4.0
docker image tag oaisoftwarealliance/oai-nssf:v1.4.0 oai-nssf:v1.4.0
docker image tag oaisoftwarealliance/trf-gen-cn5g:latest trf-gen-cn5g:latest

#可以退出docker hub登陆
docker logout

4.4下载核心网代码

makir OAI 
cd OAI 
git clone https://gitlab.eurecom.fr/oai/cn5g/oai-cn5g-fed.git

#检测一下镜像
cd oai-cn5g-fed
git checkout -f v1.4.0
#同步所有git子模块
./scripts/syncComponents.sh 

4.5部署网络-建立网桥

docker network create --driver=bridge --subnet=192.168.70.128/26 -o
"com.docker.network.bridge.name"="demo-oai" demo-oai-public-net

#其他指令
#查询是否有demo-oai的网口
ifconfig
#查询网关地址
docker network ls
#ping 一下网关看是否通了
ping 192.168.70.129

5启动核心网

#输入如下代码，允许路由表规则 ，每次开机都需再次输入
$ sudo sysctl net.ipv4.conf.all.forwarding=1
$ sudo iptables -P FORWARD ACCEPT
```bash
#查看启动帮助 
python3 core-network.py --help
#启动基础核心网
python3 core-network.py --type start-basic

6.启动后操作

#启动后查看容器运行状况 
docker ps
#观察amf里可改字段的信息
vim docker-compose-mini-nonrf.yaml

关闭核心网时保存日志

docker logs oai-amf > amf.log
docker logs oai-smf > smf.log
docker logs oai-nrf > nrf.log
docker logs oai-spgwu > spgwu.log
python3 ./core-network.py --type stop-mini
#保存位置为 docker compose

附录：

官网：openairinterface
开启网站 ： cn5g代码位置
basic——cn5g部署官方链接
参考视频： OAI（Open Air Interface）开源5G核心网部署方案（此为mini核心网）
核心网前置环境

安装docker与docker-compose