\nIf you want to fix only this issue, pick files:
\nsrc\/nas\/emm\/Attach.c
\nsrc\/nas\/ies\/SupportedCodecList.c
\nin the hereafter tar file
\nThe issue is: mme wrong decoding of smartphone codec list<\/li>\n
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.<\/p>\n
The description uses a USRP B210 board.<\/p>\n
We also explain how to simplify, fix existing issues, to make a single computer as a full LTE network: EPC+eNB.<\/p>\n
Known limitations fixed in the hereafter description<\/p>\n
- \n
- GTP UDP ports are in conflict for eNB and SGW<\/li>\n
- Useless link between OAI and the Ubuntu\/Linux hostname removed<\/li>\n
- Several simplifications and precisions to make easier and reliable installations<\/li>\n<\/ul>\n
Install Ubuntu<\/h1>\n
- \n
- Prepare a machine: a 4 actual cores, no hyper-threading.
\nAll other configuration in OAI Wiki (C1 states, …) describes is about useless.<\/li>\n - Download Ubuntu 18.04 64 bits version iso file<\/li>\n
- create a usb key to boot on it<\/li>\n
- install Ubuntu: choose to install Third party SW, and to upgrade all packages while installing<\/li>\n
- do: apt update; apt upgrade <\/em>until the machine is up-to-date<\/li>\n
- install git and configure your identification in git:\n
sudo apt install git \n git config --global user.name \"Laurent\"\n git config --global user.email \"laurent.thomas@open-cells.com\"<\/pre>\n<\/li>\n
- Add the OAI repository as authorized remote system\n
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<\/pre>\n<\/li>\n
- if you are upset with sudo password, add this line in \/etc\/sudoers\n
- \n
- xxxxxx ALL=(ALL) NOPASSWD: ALL (xxxxxx is your login name)<\/li>\n
- sudo will not ask anymore for a password<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
Install USRP drivers<\/h1>\n
We prefer to use UHD driver from source:<\/p>\n
sudo apt-get install libboost-all-dev libusb-1.0-0-dev python-mako doxygen python-docutils python-requests python3-pip cmake build-essential\npip3 install mako numpy\ngit clone git:\/\/github.com\/EttusResearch\/uhd.git\ncd uhd; mkdir host\/build; cd host\/build\ncmake -DCMAKE_INSTALL_PREFIX=\/usr ..\nmake -j4\nsudo make install\nsudo ldconfig\nsudo \/usr\/lib\/uhd\/utils\/uhd_images_downloader.py<\/pre>\n
Download our modifications<\/h1>\n
download and extract the data:<\/p>\n
cd ~\nwget https:\/\/open-cells.com\/opencells-mods-20190923.tgz<\/a>\ntar xf opencells-mods-20190923.tgz<\/pre>\n
Download and patch EPC<\/h1>\n
Clone OAI EPC:<\/p>\n
# maybe go back to home directory (leave openairinterface5g directory)\ngit clone https:\/\/gitlab.eurecom.fr\/oai\/openair-cn.git\ncd openair-cn\ngit checkout develop<\/pre>\n
We tested with commit: 724542d0b59797b010af8c5df15af7f669c1e838<\/p>\n
The Eurecom gitlab require now a login, if you don’t have one, a copy of the git repository is in:openair-cn<\/a> extract the tar with<\/em><\/p>\n
tar xf openair-cn.tgz\ncd openair-cn\ngit checkout develop<\/pre>\n
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).<\/p>\n
Apply the patch:<\/p>\n
git apply ~\/opencells-mods\/EPC.patch<\/pre>\n
The new version of the source files are also in the tar, if you want to merge with another version of OpenAir EPC<\/p>\n
What is in the patch file:<\/p>\n
- \n
- Add Ubuntu 18.04 for compilation and fix some bugs<\/li>\n
- Remove link between Linux host name and LTE diameter protocol configuration<\/li>\n
- Add usage of the input address for the SGW input socket<\/li>\n
- modify the freediameter S6a interface to fix a wrong OAI parameter<\/li>\n
- No kernel module patch is required<\/strong>: generic Ubuntu kernel 18.04 works fine with OAI<\/li>\n
- separate ASN.1 compiler installation to be compatible with other OpenAir components on the same machine (ans1c version is different for eNB and gNB)<\/li>\n<\/ul>\n
Install third party SW for EPC<\/h1>\n
cd openair-cn; source oaienv; cd scripts\n.\/build_hss -i<\/pre>\n
- \n
- Answer yes to install: freeDiameter 1.2.0<\/li>\n
- phpmyadmin:\n
- \n
- We don’t use phpmyadmin later in this procedure to update the MySQL database<\/li>\n
- We removed the installation of phpmyadmin (of course you can use it if you prefer)<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
For ubuntu 18.04, we set back the legacy mysql security level<\/p>\n
sudo mysql -u root << END\nUSE mysql;\nUPDATE user SET plugin='mysql_native_password' WHERE User='root';\nFLUSH PRIVILEGES;\nEND\n\nsudo systemctl restart mysql.service\n\nsudo mysql_secure_installation<\/pre>\n
The last command will ask a few questions:<\/p>\n
- \n
- \n
- \n
- password: set your password (linux is set in our default config files)<\/li>\n
- VALIDATE PASSWORD PLUGIN: no<\/li>\n
- Remove anonymous users: yes<\/li>\n
- Disallow root login remotely: yes<\/li>\n
- Remove test database and access to it: yes<\/li>\n
- Reload privilege tables now: yes<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
- \n
- Install 3PP SW for mme and spgw<\/li>\n<\/ul>\n
.\/build_mme -i<\/pre>\n
- \n
- Do you want to install freeDiameter 1.2.0: no<\/li>\n
- Do you want to install asn1c rev 1516 patched? <y\/N>: yes<\/li>\n
- Do you want to install libgtpnl ? <y\/N>: yes<\/li>\n
- wireshark permissions: as you prefer<\/li>\n<\/ul>\n
.\/build_spgw -i<\/pre>\n
- \n
- Do you want to install libgtpnl ? <y\/N>: no<\/li>\n<\/ul>\n
Compile the EPC nodes<\/h1>\n
No difficulty found in this phase.<\/p>\n
cd openair-cn; source oaienv; cd scripts\n.\/build_hss\n.\/build_mme\n.\/build_spgw<\/pre>\n
If you face compilation issues, the log files are in openair-cn\/build\/log<\/p>\n
In there files, look for “error:” string.<\/p>\n
Download & Compile the eNB on 18.04<\/h1>\n
git clone https:\/\/gitlab.eurecom.fr\/oai\/openairinterface5g.git\ncd openairinterface5g\ngit checkout develop<\/pre>\n
- \n
- We tested with commit edb74831dabf79686eb5a92fbf8fc06e6b267d35<\/li>\n<\/ul>\n
- \n
- Build in two steps<\/li>\n<\/ul>\n
source oaienv\u00a0\u00a0\n.\/cmake_targets\/build_oai -I\u00a0 # install SW packages from internet\n.\/cmake_targets\/build_oai -w USRP --eNB --UE # compile eNB and UE<\/pre>\n
Our Network setup description<\/h1>\n
I’ve made a simple configuration for this all-in-one setup.<\/p>\n
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.<\/p>\n
- \n
- HSS is on localhost: 127.0.0.1<\/li>\n
- eNB is on 127.0.0.10<\/li>\n
- MME is on 127.0.0.20<\/li>\n
- SPGW is on 127.0.0.30<\/li>\n<\/ul>\n
The LTE diameter configuration is now isolated from Linux hostname.<\/p>\n
realm for our EPC: “OpenAir5G.Alliance”, so, full distinguish names (FQDN) are: hss.OpenAir5G.Alliance, mme.OpenAir5G.Alliance<\/p>\n
Install this configuration for eNB<\/h2>\n
In your eNB configuration file, the network is now fixed, as lo interface always exists and our computer internal addresses also:<\/p>\n
\/\/\/\/\/\/\/\/\/\/ MME parameters:\n mme_ip_address = ( { ipv4 = \"127.0.0.20\";\n ipv6 = \"192:168:30::17\";\n active = \"yes\";\n preference = \"ipv4\";\n }\n );\n\nNETWORK_INTERFACES : \n {\n ENB_INTERFACE_NAME_FOR_S1_MME = \"lo\";\n ENB_IPV4_ADDRESS_FOR_S1_MME = \"127.0.0.10\/8\";\n\n ENB_INTERFACE_NAME_FOR_S1U = \"lo\";\n ENB_IPV4_ADDRESS_FOR_S1U = \"127.0.0.10\/8\";\n ENB_PORT_FOR_S1U = 2152; # Spec 2152\n };<\/pre>\nIn the eNB config file, you need also to set the MCC and MNC as per your SIM card:<\/p>\n
tracking_area_code = “1”;
\nmobile_country_code = “208”;
\nmobile_network_code = “92”;<\/p>\nAnd obviously, your radio parameters.<\/p>\n
Wwe tested with USRP B210 20MHz band, Huawei E3272 UE, a cavity duplexer a simple antenna, about 1 meter distance UE\/eNB antenna with this file: ~\/opencells-mods\/enb.10MHz.b200<\/p>\n
if you use the OpenAir UE, a sim card file that match our hss database example: opencells-mods\/sim.conf. We will make another tutorial to use together OpenAir UE and rf board simulation<\/p>\n
Install this configuration for EPC<\/h2>\n
For the EPC, we install in OAI default directory: \/usr\/local\/etc\/oai<\/p>\n
sudo mkdir -p \/usr\/local\/etc\/oai\nsudo cp -rp ~\/opencells-mods\/config_epc\/* \/usr\/local\/etc\/oai<\/pre>\n
cd openair-cn; source oaienv; cd scripts\n.\/check_hss_s6a_certificate \/usr\/local\/etc\/oai\/freeDiameter hss.OpenAir5G.Alliance\n.\/check_mme_s6a_certificate \/usr\/local\/etc\/oai\/freeDiameter mme.OpenAir5G.Alliance<\/pre>\n
Only the SGi output to internet need to be configured.
\nIn \/usr\/local\/etc\/oai\/spgw.conf,
\nyour should set the Ethernet interface that is connected to Internet, and,
\nto tell to the PGW to implement NAPT for the UE traffic<\/p>\nPGW_INTERFACE_NAME_FOR_SGI = \"enp3s0\"; \n PGW_MASQUERADE_SGI = \"yes\";<\/pre>\n
For the SIM card, you’ll have more to do:<\/p>\n
- \n
- SIM MCC\/MNC should be duplicated in a couple of files\n
- \n
- eNB: See above in eNB configuration chapter<\/li>\n
- MME file: \/usr\/local\/etc\/oai\/mme.conf to update<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
GUMMEI_LIST = ( MCC=\"208\" ; MNC=\"92\"; MME_GID=\"4\" ; MME_CODE=\"1\"; } );\nTAI_LIST = ({MCC=\"208\" ; MNC=\"92\"; TAC = \"1\"; } );<\/pre>\n- \n
- \n
- \n
- HSS\n
- \n
- Configure the password for MySQL\n
- \n
- in \/usr\/local\/etc\/oai\/hss.conf, set password as the password you created during MySQL installation<\/li>\n<\/ul>\n<\/li>\n
- A HSS database in text is in: ~\/opencells-mods\/opencells_db.sql\n
- \n
- We don’t use phpmyadmin: we load the database from a ascii file<\/li>\n
- It is pre-configured with the\n
- \n
- mme id<\/li>\n
- 10 users is network 208\/92 (a French test network) are also created (don’t use 3GPP test network: 001\/01: the mme fails when MCC starts by “0”)<\/li>\n<\/ul>\n<\/li>\n
- Each time you import this db, it erases<\/strong> the entire database
\n(example: you set mysql password to “linux”)<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n~\/opencells-mods\/hss_import 127.0.0.1 root linux oai_db ~\/opencells-mods\/opencells_db.sql<\/pre>\n
- \n
- \n
- \n
- \n
- \n
- \n
- \n
- We use to modify the db by updating this file with regular text editor,
\nthen we re-load the entire database,
\nbut, if you prefer, usage of http:\/\/localhost\/phpmyadmin is fine.<\/li>\n - if you modified the hss db directly, we offer a export script:\n
~\/opencells-mods\/hss_export<\/pre>\n<\/li>\n
- The important values to set are:\n
- \n
- table pdn:\n
- \n
- all IMSI are listed, with the APN: these values are in UE\/USIM<\/li>\n<\/ul>\n<\/li>\n
- table users:\n
- \n
- all IMSI, key (Ki) and OPc must be the same in USIM card<\/li>\n
- Sqn increments automatically\u00a0 when the UE authenticate in both USIM and HSS DB: it should be set as per USIM internal incrementation<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n
- SIM card update\n
- \n
- Open cells UICC and card reader will\u00a0 be supported<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
Final test and verification<\/h1>\n
open 4 terminal windows<\/p>\n
- \n
- in each window<\/li>\n<\/ol>\n
cd openair-cn; source oaienv; cd scripts; .\/run_hss<\/pre>\n
cd openair-cn; source oaienv; cd scripts; .\/run_mme<\/pre>\n
cd openair-cn; source oaienv; cd scripts; sudo -E .\/run_spgw<\/pre>\n
sudo bash\ncd ~\/openairinterface5g; source oaienv\ncd cmake_targets\/lte_build_oai\/build\n.\/lte-softmodem -O ~\/opencells-mods\/enb.10MHz.b200\n<\/pre>\n
Connect the UE, it should attach to network and be able to reach internet through OAI network.<\/p>\n
If the UE attaches, but you don’t have internet access, verify phone configuration: enable data in config->sim and verify the APN value<\/p>\n
Issues related to CPU power<\/h1>\n
If you reach performance issues: USRP\/UHD prints “LLLLL” or the process exits “problem with samples”, OVERFLOW, …<\/p>\n
The first case is to verify the USRP dialogs over USB3 (not USB2): the process must report:<\/p>\n
Found USRP B200\n-- Detected Device: B200\n-- Operating over USB 3.<\/pre>\n
For OAI source code, we wrote improvements and some hints for UE performance last year. The Linux\/Ubuntu advises can be applied to the eNB:<\/p>\n
https:\/\/gitlab.eurecom.fr\/oai\/openairinterface5g\/wikis\/setup-for-real-time-performance<\/p>\n
We may make later a post for eNB (OAI\/eNB can reach much better performance than today develop branch, but it require to enhance parts of the source code).<\/p>\n
We re-built this procedure from scratch and tested i5-6600K.<\/p>\n
On the i5-6600K, we obtained stable performance at maximum traffic over 20MHz, transmission mode 1 (SISO), duplexer, antenna, E3372 UE (one single UE) over-the-air 10 cm distance :<\/p>\n
![\"\"](\"https:\/\/open-cells.com\/wp-content\/uploads\/2017\/08\/speedtest-300x130.png\")
<\/p>\n","protected":false},"excerpt":{"rendered":"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 … Continue reading “All in one OpenAirInterface”<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":true,"template":"","format":"standard","meta":{"_crdt_document":"","footnotes":""},"categories":[1],"tags":[],"class_list":["post-371","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/open-cells.com\/index.php\/wp-json\/wp\/v2\/posts\/371","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/open-cells.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/open-cells.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/open-cells.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/open-cells.com\/index.php\/wp-json\/wp\/v2\/comments?post=371"}],"version-history":[{"count":50,"href":"https:\/\/open-cells.com\/index.php\/wp-json\/wp\/v2\/posts\/371\/revisions"}],"predecessor-version":[{"id":3066,"href":"https:\/\/open-cells.com\/index.php\/wp-json\/wp\/v2\/posts\/371\/revisions\/3066"}],"wp:attachment":[{"href":"https:\/\/open-cells.com\/index.php\/wp-json\/wp\/v2\/media?parent=371"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/open-cells.com\/index.php\/wp-json\/wp\/v2\/categories?post=371"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/open-cells.com\/index.php\/wp-json\/wp\/v2\/tags?post=371"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
- in each window<\/li>\n<\/ol>\n
- Open cells UICC and card reader will\u00a0 be supported<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
- table pdn:\n
- We use to modify the db by updating this file with regular text editor,
- \n
- \n
- \n
- Configure the password for MySQL\n
- HSS\n
- \n
- SIM MCC\/MNC should be duplicated in a couple of files\n
- Build in two steps<\/li>\n<\/ul>\n
- We tested with commit edb74831dabf79686eb5a92fbf8fc06e6b267d35<\/li>\n<\/ul>\n
- Do you want to install libgtpnl ? <y\/N>: no<\/li>\n<\/ul>\n
- Install 3PP SW for mme and spgw<\/li>\n<\/ul>\n
- \n
- separate ASN.1 compiler installation to be compatible with other OpenAir components on the same machine (ans1c version is different for eNB and gNB)<\/li>\n<\/ul>\n
- install git and configure your identification in git:\n
- Prepare a machine: a 4 actual cores, no hyper-threading.