\n(non modified ones since the June version were missing)<\/li>\n
This document explains how to install and configure OAI EPC+eNB on one single Ubuntu 17.04 64 bits machine connected with a regular UE (a Huawei E3272), routing the UE traffic to internet.<\/p>\n
We use EPC after a major contribution in May 2017: a lot of code has been modified, all directories names were changes, configuration parameters names\/values changed.<\/p>\n
The description uses a USRP B210 board, a Lime SDR page is provided separately.<\/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
- OAI EPC require kernel >= 4.7, so we have to use Ubuntu 17.04\n
- \n
- We already pushed some enhancements in OAI, nevertheless some more are required<\/li>\n<\/ul>\n<\/li>\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 17.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
Ettus has not yet released their driver for Ubuntu 17.04, we take it from source:<\/p>\n
sudo apt-get install libboost-all-dev libusb-1.0-0-dev python-mako doxygen python-docutils python-requests cmake build-essential\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: patches<\/a> extract the data:<\/p>\n
tar xf opencells-mods-20170710.tgz<\/pre>\n
Download & Compile the eNB on 17.04<\/h1>\n
git clone https:\/\/gitlab.eurecom.fr\/oai\/openairinterface5g.git\ncd openairinterface5g\ngit checkout develop<\/pre>\n
- \n
- We tested with commit 08b8b3142df16831396a5283a015564ff56bf91c<\/li>\n<\/ul>\n
We already merged in develop most of updates for Ubuntu 17.04, so we need only to add in build_helper file the Ubuntu 17.04 support<\/p>\n
git apply opencells-mods\/eNB.patch<\/pre>\n
- \n
- Now, you should be able to build as usual the eNB<\/li>\n<\/ul>\n
source oaienv \n.\/cmake_targets\/build_oai -I # install SW packages from internet\n.\/cmake_targets\/build_oai -w USRP --eNB --UE # compile eNB<\/pre>\n
Download and patch EPC<\/h1>\n
Clone OAI EPC:<\/p>\n
git clone https:\/\/gitlab.eurecom.fr\/oai\/openair-cn.git\ncd openair-cn\ngit checkout develop<\/pre>\n
(we used: commit 5353b606662a6ae7eaadf6bc39cbf6452d298b0e)<\/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 17.04 for compilation and fix some bugs\n
- \n
- build\/tools\/build_helper<\/em><\/li>\n
- src\/common\/common_defs.h<\/em><\/li>\n
- src\/oai_hss\/utils\/hss_config.c<\/em><\/li>\n<\/ul>\n<\/li>\n
- Remove link between Linux host name and LTE diameter protocol configuration\n
- \n
- src\/s6a\/s6a_peer.c<\/em><\/li>\n<\/ul>\n<\/li>\n
- Add usage of the input address for the SGW input socket\n
- \n
- src\/gtpv1-u\/gtp_mod_kernel.c<\/em><\/li>\n
- src\/gtpv1-u\/gtp_mod_kernel.h<\/em><\/li>\n
- src\/gtpv1-u\/gtpv1u_task.c<\/em><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
No kernel module patch is required<\/strong> anymore: generic Ubuntu kernel 17.04 works fine with OAI<\/p>\n
Install third party SW for EPC<\/h1>\n
cd openair-cn; source oaienv; cd scripts\n.\/build_hss -i<\/pre>\n
- \n
- Do you want to install freeDiameter 1.2.0 ?: yes<\/li>\n
- set your MySQL password and remember it!<\/li>\n
- Answer yes to install: freeDiameter 1.2.0<\/li>\n
- phpmyadmin:\n
- \n
- choose light or apache as you prefer<\/li>\n
- Configure database for phpmyadmin with dbconfig-common: yes<\/li>\n
- password: same as MySQL for simplicity<\/li>\n
- We don’t use phpmyadmin later in this procedure, nevertheless we tested successfully also with it<\/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>: no<\/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
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 and two parameter files: 10MHz band, 20MHz band, Huawei E3272 UE, a cavity duplexer a simple antenna, about 1 meter distance UE\/eNB antenna.<\/p>\n
- \n
- openairinterface5g\/targets\/PROJECTS\/GENERIC-LTE-EPC\/CONF\/enb.band7.tm1.50PRB.usrpb210.conf<\/li>\n
- openairinterface5g\/targets\/PROJECTS\/GENERIC-LTE-EPC\/CONF\/enb.band7.tm1.100PRB.usrpb210.conf<\/li>\n<\/ul>\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.\/hss_db_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 - 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 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 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\n.\/cmake_targets\/lte_build_oai\/build\/lte-softmodem -O <your config file>\n<\/pre>\n
Connect the UE, it should attach to network and be able to reach internet through OAI network<\/p>\n
We re-built this procedure from scratch and tested two machines: i5-4570 and i5-6600K.<\/p>\n
On the i5-4570, at maximum traffic, the eNB is stable on 10MHz band at full user data speed.<\/p>\n
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:<\/p>\n
![\"\"](\"http:\/\/open-cells.com\/wp-content\/uploads\/2017\/06\/speedtest-300x185.png\")
<\/p>\n","protected":false},"excerpt":{"rendered":"(updated: 2017, July 10th) Modifs since version on July 6th: Latest commit Fix lacking file in the tarball (non modified ones since the June version were missing) improved code pieces formating in HTML, added automatic git patch Full re-test, from disk install of Ubuntu 17.04 to UE throughput measurement This document explains how to install … Continue reading “(obsolete) OpenAir, single machine Ubuntu 17.04, after major EPC update”<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_crdt_document":"","footnotes":""},"categories":[1],"tags":[],"class_list":["post-236","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/open-cells.com\/index.php\/wp-json\/wp\/v2\/posts\/236","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=236"}],"version-history":[{"count":26,"href":"https:\/\/open-cells.com\/index.php\/wp-json\/wp\/v2\/posts\/236\/revisions"}],"predecessor-version":[{"id":1537,"href":"https:\/\/open-cells.com\/index.php\/wp-json\/wp\/v2\/posts\/236\/revisions\/1537"}],"wp:attachment":[{"href":"https:\/\/open-cells.com\/index.php\/wp-json\/wp\/v2\/media?parent=236"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/open-cells.com\/index.php\/wp-json\/wp\/v2\/categories?post=236"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/open-cells.com\/index.php\/wp-json\/wp\/v2\/tags?post=236"}],"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 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
- Do you want to install libgtpnl ? <y\/N>: no<\/li>\n<\/ul>\n
- Install 3PP SW for mme and spgw<\/li>\n<\/ul>\n
- src\/gtpv1-u\/gtp_mod_kernel.h<\/em><\/li>\n
- Add usage of the input address for the SGW input socket\n
- src\/common\/common_defs.h<\/em><\/li>\n
- build\/tools\/build_helper<\/em><\/li>\n
- Add Ubuntu 17.04 for compilation and fix some bugs\n
- Now, you should be able to build as usual the eNB<\/li>\n<\/ul>\n
- We tested with commit 08b8b3142df16831396a5283a015564ff56bf91c<\/li>\n<\/ul>\n
- install git and configure your identification in git:\n
- Prepare a machine: a 4 actual cores, no hyper-threading.