== !OpenAirInterface LTE == 


This tutorial also assumes basic familiarity with [http://en.wikipedia.org/wiki/LTE_%28telecommunication%29 LTE standard]. It uses [http://www.openairinterface.org/ OpenAirInterface] open source software implementation of LTE basestation (eNodeB or eNB) and modem (user equipment or UE) developed at [http://www.eurecom.fr/en Eurecom]. The tutorial given here is based on the [https://twiki.eurecom.fr/twiki/bin/view/OpenAirInterface/OpenAirLXRT OAI_real-time_LTEsoftmodem] tutorial.

The image used for this experiment is oai-trunk-head.ndz. Image uses Ubunutu 14.04 and has low-latency 3.19 kernel install and UHD drivers needed for B210/X310 USRPs (UHD 3.8.2)). This image was derived from vanilla image ubuntu-14-04-64bit-3.19-lowlatency.ndz (that was created based on [https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/OpenAirKernelMainSetup OpenAir instructions]) from ubutbu-14-04-64bit.ndz (baseline.ndz). In addition to installation steps in !OpenAir documentation, once low latency kernel was installed, [wiki:Software/hDrivers drivers for Broadcom and Netgear devices] had to be manually re-installed. 

Two images were created based on [https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/GetSources git cloning instructions] and [https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/AutoBuild compiling instructions]:

 * '''oai-master.ndz''' - master branch clone from git in /root

 * '''oai-develop.ndz''' - develop branch clone from git in /root

The openair-cn (EPC) was installed with default passwords of '''oai''' and default choice of "N" for optional packages (freeDiameter, asn1c pach and xtables_addons_oai). xtables_addons_oai was pulled out of git but not installed.  

Update for '''oai-develop.ndz''': The openair-cn (EPC) was installed with default passwords of '''oai''' and default choice of "Y" for optional packages (freeDiameter, asn1c pach and xtables_addons_oai). xtables_addons_oai was pulled out of git and installed.

 
------------------------

=== Quickstart Option ===

'''Note''' If you intend to use graphical user interface please make sure to install appropriate tools on your local machine and configure X11 forwarding

We have an image available, named {{{oai-dev.ndz}}}. It has all the necessary driver and software pre-installed, and two scripts available to immediately boot up the eNB and UE. This quickstart assumes use of Sandbox1, nodes 1-1, and 1-2. 

1. To proceed, after having a reservation, load the following image.
 * {{{omf load -t node1-1,node1-2 -i oai-dev.ndz}}}
 * The nodes will automatically turn off when imaging is completed.
1. Turn the nodes on.
 * {{{omf tell -a on -t node1-1,node1-2}}}
1. Open a terminal to each node. You must enable X11 Forwarding to see the GUI and statistics screens.
1. On the first node, execute script {{{./CompandRuneNB}}}
1. On the second node, execute script {{{./CompandRunUE}}}
1. For subsequent runs, execute {{{./runeNB}}} or {{{./runUE}}} instead, to avoid recompiling.
1. These scripts will create interface {{{oai0}}} and assign an address.
 1. Use {{{ifconfig}}} or {{{ip a}}} to see the address assigned.
 1. By default the eNB has address 10.0.1.1, and the UE has addresss 10.0.1.9, but you should double check.
1. You should be able to ping from one node to the other on these addresses.
 1. From UE, {{{ping 10.0.1.1}}} or to see live statistics {{{mtr 10.0.1.1}}}
1. For throughput testing
 1. On the eNB, execute {{{iperf -s}}}
 1. On the UE, execute {{{iperf -c 10.0.1.1}}}


Sample output looks like:

[Image(Scope.png)]