View source for OpenAirInterface-CN: Install

penAirInterface
November 28th 2019: fix from user review

September 23rd 2019: minor fix of warnings

September 2019, large rework and update to latest eNB

June 21st 2019: replace ubuntu 17.04 by ubuntu 18.04

Sept 7th 2017: small update for more recent eNB git commit version in develop branch

Starting condition:
Ubuntu 18.04 all packages upgraded, uhd last commit, OAI last commit

Modifications

Latest commits
Fix a issue in mme that crash mme with some phones in the attach-request procedure
If you want to fix only this issue, pick files:
src/nas/emm/Attach.c
src/nas/ies/SupportedCodecList.c
in the hereafter tar file
The issue is: mme wrong decoding of smartphone codec list
Full re-test, from disk install of Ubuntu 17.04 to commercial UEs throughput measurement (Android 5 and Android 6)
This document explains how to install and configure OAI EPC+eNB on one single Ubuntu 18.04 64 bits machine connected with a regular UE, routing the UE traffic to internet.

The description uses a USRP B210 board.

We also explain how to simplify, fix existing issues, to make a single computer as a full LTE network: EPC+eNB.

Known limitations fixed in the hereafter description

GTP UDP ports are in conflict for eNB and SGW
Useless link between OAI and the Ubuntu/Linux hostname removed
Several simplifications and precisions to make easier and reliable installations
Install Ubuntu
Prepare a machine: a 4 actual cores, no hyper-threading.
All other configuration in OAI Wiki (C1 states, …) describes is about useless.
Download Ubuntu 18.04 64 bits version iso file
create a usb key to boot on it
install Ubuntu: choose to install Third party SW, and to upgrade all packages while installing
do: apt update; apt upgrade until the machine is up-to-date
install git and configure your identification in git:
 sudo apt install git 
 git config --global user.name "Laurent"
 git config --global user.email "laurent.thomas@open-cells.com"
Add the OAI repository as authorized remote system
echo -n | openssl s_client -showcerts -connect gitlab.eurecom.fr:443 2>/dev/null | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' | sudo tee -a /etc/ssl/certs/ca-certificates.crt
if you are upset with sudo password, add this line in /etc/sudoers
xxxxxx ALL=(ALL) NOPASSWD: ALL (xxxxxx is your login name)
sudo will not ask anymore for a password
Install USRP drivers
We prefer to use UHD driver from source:

sudo apt-get install libboost-all-dev libusb-1.0-0-dev python-mako doxygen python-docutils python-requests python3-pip cmake build-essential
pip3 install mako numpy
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
Download our modifications
download and extract the data:

cd ~
wget https://open-cells.com/opencells-mods-20190923.tgz
tar xf opencells-mods-20190923.tgz
Download and patch EPC
Clone OAI EPC:

# maybe go back to home directory (leave openairinterface5g directory)
git clone https://gitlab.eurecom.fr/oai/openair-cn.git
cd openair-cn
git checkout develop
We tested with commit: 724542d0b59797b010af8c5df15af7f669c1e838

The Eurecom gitlab require now a login, if you don’t have one, a copy of the git repository is in:openair-cn extract the tar with

tar xf openair-cn.tgz
cd openair-cn
git checkout develop
This is the last commit for OAI EPC on this development tree. Active OpenAir EPC is now another project on github. We use here this legacy EPC because the installation is quite easy (the new project uses Cassandra, al LOT of virtual machines, OpenVswitch and complex dependancies).

Apply the patch:

git apply ~/opencells-mods/EPC.patch
The new version of the source files are also in the tar, if you want to merge with another version of OpenAir EPC

What is in the patch file:

Add Ubuntu 18.04 for compilation and fix some bugs
Remove link between Linux host name and LTE diameter protocol configuration
Add usage of the input address for the SGW input socket
modify the freediameter S6a interface to fix a wrong OAI parameter
No kernel module patch is required: generic Ubuntu kernel 18.04 works fine with OAI
separate ASN.1 compiler installation to be compatible with other OpenAir components on the same machine (ans1c version is different for eNB and gNB)
Install third party SW for EPC
cd openair-cn; source oaienv; cd scripts
./build_hss -i
Answer yes to install: freeDiameter 1.2.0
phpmyadmin:
We don’t use phpmyadmin later in this procedure to update the MySQL database
We removed the installation of phpmyadmin (of course you can use it if you prefer)
For ubuntu 18.04, we set back the legacy mysql security level

sudo mysql -u root << END
USE mysql;
UPDATE user SET plugin='mysql_native_password' WHERE User='root';
FLUSH PRIVILEGES;
END

sudo systemctl restart mysql.service

sudo mysql_secure_installation
The last command will ask a few questions:

password: set your password (linux is set in our default config files)
VALIDATE PASSWORD PLUGIN: no
Remove anonymous users: yes
Disallow root login remotely: yes
Remove test database and access to it: yes
Reload privilege tables now: yes
Install 3PP SW for mme and spgw
./build_mme -i
Do you want to install freeDiameter 1.2.0: no
Do you want to install asn1c rev 1516 patched? <y/N>: yes
Do you want to install libgtpnl ? <y/N>: yes
wireshark permissions: as you prefer
 ./build_spgw -i
Do you want to install libgtpnl ? <y/N>: no
Compile the EPC nodes
No difficulty found in this phase.

cd openair-cn; source oaienv; cd scripts
./build_hss
./build_mme
./build_spgw
If you face compilation issues, the log files are in openair-cn/build/log

In there files, look for “error:” string.