OpenAirInterface (OAI) Ubuntu 17.04/16.04 All In One 安装教程

小灰灰 2022-06-12 06:45 1018阅读 0赞

国外有一个大神写了一个基于Ubuntu 17.04安装OAI eNB，UE和EPC一整套系统的教程。原文链接[https://open-cells.com/index.php/2017/06/07/openair-single-machine-ubuntu-17-04-after-major-epc-update/][https_open-cells.com_index.php_2017_06_07_openair-single-machine-ubuntu-17-04-after-major-epc-update] 。笔者在此基础上进行修改后在17.04和16.04上都已搭建成功，实验在USRPB210和一台i5的笔记本上， 5M 带宽下基本能接入2个手机稳定运行。10M/20M特别是双天线会受电脑性能影响而发生丢包。

注意：文中蓝色粗体字都是要执行的命令

**安装 Ubuntu**

*  **关于ubuntu系统：由于17.04 ubuntu已经于2018.1月停止维护，因此17.04安装将无法进行，只能使用16.04 64bits版本的系统。**
 *  电脑要求： 4 actual cores, no hyper-threading. **usb3.0(very important)**  
    
 *  系统版本： **Ubuntu  16.04 64 bits.**
 *  装好系统后: **apt update; apt upgrade.**
 *  安装 **git** and configure your identification in git:  
    **sudo apt install git **

*  为了每次执行sudo命令后输入密码, 在 /etc/sudoers文件加入下面两行  
    **xxxxxx ALL=(ALL) NOPASSWD: ALL** (xxxxxx is your login name)  
    sudo will not ask anymore for a password

**安装 USRP 驱动**

**sudo apt-get install libboost-all-dev libusb-1.0-0-dev python-mako doxygen python-docutils python-requests cmake build-essential**  
**git clone git://github.com/EttusResearch/uhd.git**  
**cd uhd; mkdir host/build; cd host/build**  
**cmake -DCMAKE\_INSTALL\_PREFIX=/usr ..**  
**make -j4**  
**sudo make install**  
**sudo ldconfig**  
**sudo /usr/lib/uhd/utils/uhd\_images\_downloader.py**

**也可以将zip文件download后保存好后，手动解压缩到/sur/share/uhd/image .**

**或者按照官方文档安装：**

https://kb.ettus.com/Building\_and\_Installing\_the\_USRP\_Open-Source\_Toolchain\_(UHD\_and\_GNU\_Radio)\_on\_Linux

**安装usrp驱动可能后可能会遇到的问题：**

**注意：安装UHD驱动后，会出现非root用户权限的问题，使用sudo也能识别USRP，但后面执行程序的时候会出问题。解决方法如下：**

**cd /usr/lib/uhd/utils   或者：cd /usr/local/lib/uhd/utils 看你默认安装在哪里**

**sudo cp uhd-usrp.rules /etc/udev/rules.d/ **

**sudo udevadm control --reload-rules   
sudo udevadm trigger**

# 下载OAI修改补丁 #

download: [patches][]

然后解压，然后将里面的opencells-mods 文件夹拷贝到后面下载 openairinterface和openair-cn目录里面.

**下载&编译 eNB on 16.04**

**git clone https://gitlab.eurecom.fr/oai/openairinterface5g.git**  
**下载是否能成功与网速有关，网速太慢可能很难成功。可以将之前下载的打包备用，以后不用每次下载.**  
**cd openairinterface5g**  
**git checkout develop**  
**git reset --hard 7580d021d**  
**git log**

*  We tested with commit 7580d021d387cc63fcf6ecbb97a87b816676a06f  Tue Jun 6 17:59:32 2017 +0200
 *  **注意版本号，那一串commit  log 数字要对上,否在可能出现问题**
 *  编译前要使用补丁文件替换对应文件：
 *  替换 cmake\_targets/tools/build\_helper  文件:
 *  **cp   opencells-mods/cmake\_targets/tools/build\_helper    cmake\_targets/tools/build\_helper**
 *  编译：依赖安装->编译  
    **source oaienv  **\# 设置环境  
    **./cmake\_targets/build\_oai -I**       \# 安装第三方软件包，直到出现下面界面表示安装完成
    
     *  ![70][]
    
    **./cmake\_targets/build\_oai  -w USRP --eNB --UE** \# compile eNB**（如果出错去掉--UE, 16.04版本的ubuntu系统不能加--UE, 17.04需要加上）**  
    
    
     *  **![70 1][]**  
        
     *  **![70 2][]**

**可能会出现下面错误：**

git found: /usr/bin/git  
CMake Error at /home/nano/openairinterface5g/cmake\_targets/CMakeLists.txt:302 (message):  
  /home/nano/openairinterface5g/cmake\_targets/tools/generate\_asn1: error  
Call Stack (most recent call first):  
  CMakeLists.txt:19 (include)  
  
\-- Configuring incomplete, errors occurred!  
build have failed

**一般是由于文件夹拷贝导致里面可执行文件没有执行权限。** **可对整个文件加可执行权限解决，EPC安装出问题可类似处理。**

**chmod -R +x openairinterface5g**

# 下载 EPC并打补丁 #

**git clone https://gitlab.eurecom.fr/oai/openair-cn.git**  
**cd openair-cn**  
**git checkout develop**  
**git reset \--hard 67180ca07c**  
**git log**

(we used: commit **67180ca07c3f543fb6efde13bfdd88ec153185c7** **Date: Tue May 30 10:16:31 2017 +0200**)

**注意版本号，那一串commit  log 数字要对上,否在可能出现问题**

**cp opencells-mods/build/tools/build\_helper  build/tools/build\_helper       **  
**patch -i opencells-mods/src/common/common\_defs.h.patch src/common/common\_defs.h**  
**patch -i opencells-mods/src/oai\_mme/oai\_mme.c.patch src/oai\_mme/oai\_mme.c （这行patch的时候不成功，直接copy覆盖处理）**  
  
**patch -i opencells-mods/src/oai\_hss/utils/hss\_config.c.patch src/oai\_hss/utils/hss\_config.c**  
**patch -i opencells-mods/src/s6a/s6a\_peer.c.patch src/s6a/s6a\_peer.c**  
**patch -i opencells-mods/src/gtpv1-u/gtp\_mod\_kernel.c.patch src/gtpv1-u/gtp\_mod\_kernel.c**  
**patch -i opencells-mods/src/gtpv1-u/gtp\_mod\_kernel.h.patch src/gtpv1-u/gtp\_mod\_kernel.h**  
**patch -i opencells-mods/src/gtpv1-u/gtpv1u\_task.c.patch src/gtpv1-u/gtpv1u\_task.c**

# 为 EPC 安装第三方软件包 #

*  **cd openair-cn**
 *  **source oaienv**
 *  **cd scripts**
 *  **./build\_hss -i   **
 *  **安装过程中会提示一些软件是否需要安装，如果没有选择yes，安装过的可选no跳过**  
    
    
     *  Do you want to install **freeDiameter** 1.2.0 ?: **yes**
     *  set your **MySQL** password and remember it!
     *  **phpmyadmin**:
        
         *  choose light or **apache** as you prefer
         *  Configure database for phpmyadmin with dbconfig-common: **yes**
         *  password: same as MySQL for simplicity
         *  We don't use phpmyadmin later in this procedure, nevertheless we tested successfully also with it
 *  Install 3PP SW for mme and spgw
 *  **./build\_mme -i**
 *  **前面安装过的选择no不用重复安装**  
    
    
     *  Do you want to install freeDiameter 1.2.0: **no**
     *  Do you want to install asn1c rev 1516 patched? <y/N>: **no**
     *  Do you want to install libgtpnl ? <y/N>: **yes**
     *  wireshark permissions: as you prefer
     *  ![70 3][]  
        
 *  **./build\_spgw -i**
    
     *  Do you want to install libgtpnl ? <y/N>: **no**
     *  **![70 4][]**

# 编译 EPC #

**cd openair-cn**  
**source oaienv**  
**cd scripts**  
**./build\_hss     \#有error 解决如下  
./build\_mme  \#有error 解决如下**

**./build\_spgw  \#有error 解决如下**

![Center][]![Center 1][]![Center 2][]![70 5][]![70 6][]![70 7][]

# Our Network setup description（网络配置说明，跳过） #

I’ve made a simple configuration for this all-in-one setup.

Each node is on a separate IP address, this address is used for all it’s interfaces. In our case of all-in-one, we take addresses on the loopback: this will be fine on all your machines.

*  HSS is on localhost: 127.0.0.1
 *  eNB is on 127.0.0.10
 *  MME is on 127.0.0.20
 *  SPGW is on 127.0.0.30

The LTE diameter configuration is now isolated from[linux][] hostname.

realm for our EPC: “OpenAir5G.Alliance”, so, full distinguish names (FQDN) are: hss.OpenAir5G.Alliance, mme.OpenAir5G.Alliance

## Install this configuration for eNB（修改基站参数配置） ##

We tested with USRP B210 and two parameter files: 10MHz band, 20MHz band, Huawei E3272 UE, a cavity duplexer a simple antenna, about 1 meter distance UE/eNB antenna.

*  **openairinterface5g/targets/PROJECTS/GENERIC-LTE-EPC/CONF/enb.band7.tm1.50PRB.usrpb210.conf**
 *  **openairinterface5g/targets/PROJECTS/GENERIC-LTE-EPC/CONF/enb.band7.tm1.100PRB.usrpb210.conf**

In your eNB configuration file, the network is now fixed, as lo interface always exists and our computer internal addresses also:

// MME parameters:
     mme_ip_address = ( { ipv4 = "127.0.0.20";
     ipv6 = "192:168:30::17";
     active = "yes";
     preference = "ipv4";
     }
     );
    
    NETWORK_INTERFACES : 
     {
     ENB_INTERFACE_NAME_FOR_S1_MME = "lo";
     ENB_IPV4_ADDRESS_FOR_S1_MME = "127.0.0.10/8";
    
    ENB_INTERFACE_NAME_FOR_S1U = "lo";
     ENB_IPV4_ADDRESS_FOR_S1U = "127.0.0.10/8";
     ENB_PORT_FOR_S1U = 2152; # Spec 2152
     };

In the eNB config file, you need also to set the MCC and MNC as per your SIM card:

**tracking\_area\_code = “1”;  
mobile\_country\_code = “208”;  
mobile\_network\_code = “92”;**

And obviously, your radio parameters.

## Install this configuration for EPC （配置核心网参数） ##

For the EPC, we install in OAI default directory: /usr/local/etc/oai

*  **会用到前面补丁里面的文件**

**sudo mkdir -p   /usr/local/etc/oai**  
**sudo cp  -rp  opencells-mods/config\_epc/\*    /usr/local/etc/oai**

Then, you should generate the cyphering certificates:

**cd openair-cn;  source oaienv;  cd scripts**  
**./check\_hss\_s6a\_certificate    /usr/local/etc/oai/freeDiameter hss.OpenAir5G.Alliance**

**./check\_mme\_s6a\_certificate   /usr/local/etc/oai/freeDiameter mme.OpenAir5G.Alliance**

# Only the SGi output to internet need to be configured.(**设置外网网卡**) #

In **/usr/local/etc/oai/spgw.conf,**  
your should set the Ethernet interface that is connected to Internet, and,  
to tell to the PGW to implement NAPT for the UE traffic

这里根据自己的外网填写，我的是 **wlp5s0**

PGW_INTERFACE_NAME_FOR_SGI = "wlp5s0"; 
     PGW_MASQUERADE_SGI = "yes";

For the SIM card, you'll have more to do:(根据测试SIM卡配置MCC/MNC/TAC等参数)

*  SIM MCC/MNC should be duplicated
    
     *  **eNB**: See above in eNB configuration chapter
     *  **MME**
        
         *  file: **/usr/local/etc/oai/mme.conf** to update
            
             *  **GUMMEI\_LIST = ( MCC=”208″ ; MNC=”92″; MME\_GID=”4″ ; MME\_CODE=”1″; \} );**
             *  **TAI\_LIST = (\{MCC=”208″ ; MNC=”92″; TAC = “1”; \} );**
     *  **HSS**
        
         *  Configure the password for MySQL
            
             *  in **/usr/local/etc/oai/hss.conf**, set password as the password you created during MySQL installation（**设置访问数据库的root用户密码**）
         *  A HSS database in text is in: **opencells-mods/opencells\_db.sql**
            
             *  It is pre-configured with the mme id
             *  A SIM user in network 001/01 (the test network defined by 3GGP) is already created.
             *  10 users is network 208/92 (a French test network) are also created
             *  Each time you import this db, it erases the entire database  
                (example: you set mysql password to “linux”)
                
                 *  **./hss\_db\_import 127.0.0.1 root linux oai\_db opencells-mods/opencells\_db.sql**
             *  We use to modify the db by updating this file with regular text editor,  
                then we re-load the entire database,  
                but, if you prefer, usage of http://localhost/phpmyadmin is fine
             *  The **important values** to set are:
                
                 *  table **pdn**:
                    
                     *  all **IMSI** are listed, with the **APN**: these values are in UE/USIM
                 *  table **users**:
                    
                     *  all **IMSI**, key (**Ki**) and **OPc** must be the same in**USIM** card
                     *  Sqn increments automatically  when the UE authenticate in both USIM and HSS DB: it should be set as per USIM internal incrementation
         *  SIM card update
            
             *  Open cells UICC and card reader will  be supported

可能遇到的问题：

1.      如果报错：error2002：can't connect to local mysql server through socket。

检查后发现mysql-server并没有自动安装。为了避免后续导入数据库出错，重新安装了系统和内核，在执行此步骤前先手动安装mysql-server，问题解决。

2.      在浏览器输入**http://127.0.0.1/phpmyadmin**,出现not found界面。

需要在Apache配置中添加phpmyadmin

打开apache.conf文件：

vim /etc/apache2/apache2.conf

添加下面语句：

Include /etc/phpmyadmin/apache.conf

重新启动apache服务：

/etc/init.d/apache2 restart

**其他可能出现的问题，参见其他博客：**

**https://blog.csdn.net/wxsdr/article/details/53691763**

\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*

## 写白卡： ##

写 **http://127.0.0.1/phpmyadmin **  里面的参数就可以啦，

里面预设了10个IMSI ：**208920100001100-208920100001109**

**Ki：6874736969202073796d4b2079650a73**

**       OPC： 504f20634f6320504f50206363500a4f**

**       R1-R5:  4000204060**

**      短消息中心随便填: **

**写卡软件：**

**![70 8][]**

#### **连接读卡器** ####

**![70 9][]**

**![70 10][]**

### **写卡：** ###

**![70 11][]**

### **读卡：** ###

**![70 12][]**

![70 13][]![70 14][]

##     ##

## 手机设置： ##

添加APN。

移动网络->接入点名称（APN）->添加APN(名字随便取），APN为oai.ipv4，其余的都不用填。还要开启数据漫游。

插入白卡，重启手机或者开关飞行模式。

手动扫描网络。

另外，作为测试机可以再安装一款网优分析软件 信号大师，或者网优大师。信号大师可以锁定网锁频段，在测试时锁频段后可以加快接入eNB的速度。

## **测试验证** ##

测试前最好打开wireshark 抓包，后面启动所有进程后可以抓到S1SetupRequest 和 S1SetupResponse的包，后面如果有UE接入，还会抓到nas信令的包，这些都可以用于调试观察一些过程。善于使用wireshark工具分析是必备技能。

![70 15][]

**一次正常的联网过程的信令交互流程：**

![70 16][]

打开4个终端，顺序启动hss, mme, spgw, eNB:

1.  启动hss  
    **cd openair-cn; source oaienv; cd SCRIPTS; ./run\_hss**
2.  启动mme  
    **cd openair-cn; source oaienv; cd SCRIPTS; ./run\_mme**
3.  启动spgw  
    **cd openair-cn; source oaienv; cd SCRIPTS; sudo -E ./run\_spgw**
4.  启动eNB  
    **sudo bash**  
    **cd openairinterface5g; source oaienv**  
    **cd cmake\_targets/lte\_build\_oai/build**  
    **sudo ./lte-softmodem -d -O ~/openairinterface5g/targets/PROJECTS/GENERIC-LTE-EPC/CONF/enb.band7.tm1.usrpb210.conf**
5.  Connect the UE, it should attach to network and be able to reach internet through OAI networ

We re-built this procedure from scratch and tested two machines: i5-4570 and i5-6600K.

On the i5-4570, at maximum traffic,**the eNB is stable on 10MHz band at full user data speed**.

On the i5-6600K, we obtain stable performance at maximum traffic over **20MHz, transmission mode 1 (SISO)**,**one single UE over-the-air 1 meter distance**:

我的电脑配置 i5-6700HQ CPU, 5M带宽还算稳定，10M 20M 貌似有点不稳定。截了2张图

![SouthEast][]

[https_open-cells.com_index.php_2017_06_07_openair-single-machine-ubuntu-17-04-after-major-epc-update]: https://open-cells.com/index.php/2017/06/07/openair-single-machine-ubuntu-17-04-after-major-epc-update/
[patches]: https://github.com/xrh003/OAI_ALLINONE_patch/archive/master.zip
[70]: /images/20220612/f0e2395385da4dd49bd2379866b307d1.png
[70 1]: /images/20220612/4c3cc24370ac4bb0b2b4b1d45366f03d.png
[70 2]: /images/20220612/ab3f93aed78c4ef892f97874a3cefdd0.png
[70 3]: /images/20220612/dd54e0e4087c4120a42e371df079c52c.png
[70 4]: /images/20220612/730c39264d5047149ecb87fb8a5b0746.png
[Center]: https://img-blog.csdn.net/20170816234727870?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveHJoMDAz/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center
[Center 1]: https://img-blog.csdn.net/20170816234831479?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveHJoMDAz/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center
[Center 2]: https://img-blog.csdn.net/20170816234836200?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveHJoMDAz/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center
[70 5]: https://img-blog.csdn.net/20180509093922717?watermark/2/text/aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hyaDAwMw==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70
[70 6]: https://img-blog.csdn.net/2018050909432160?watermark/2/text/aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hyaDAwMw==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70
[70 7]: /images/20220612/78a4dc66f31946188af620987e73452d.png
[linux]: http://lib.csdn.net/base/linux
[70 8]: /images/20220612/223e8a0ad25041399d852f36f3a74244.png
[70 9]: /images/20220612/dded10824e334c07b0b90d456a36a096.png
[70 10]: /images/20220612/21a9f0afc8974af3a213f589f04acfb4.png
[70 11]: /images/20220612/e55892fdd5b44c77826cb77ff2c47eff.png
[70 12]: /images/20220612/ba4c7a74ec7b44b6be9d859f47216172.png
[70 13]: https://img-blog.csdn.net/20180510170806825?watermark/2/text/aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hyaDAwMw==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70
[70 14]: /images/20220612/84b0a08518f44c939c0d8f26deefff9d.png
[70 15]: /images/20220612/8fca10f2247c44ceb0fd96d092777b20.png
[70 16]: /images/20220612/d6b9fd367d4a4efd9186d9227a7ecbcf.png
[SouthEast]: /images/20220612/1f26d3ea3dee4524af6090ba433133d3.png