Changes between Initial Version and Version 1 of GENILTE/LTEDeploymentRutgers


Ignore:
Timestamp:
09/19/17 12:36:44 (7 years ago)
Author:
lnevers@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GENILTE/LTEDeploymentRutgers

    v1 v1  
     1= GENI LTE EPC DOCUMENTATION =
     2
     3= 1.0 Introduction =
     4
     5The purpose of this document is to outline the procedure needed to congure
     6the GENI Test LTE EPC located at Rutgers Orbit Winlab. The main goal that
     7was accomplished from this procedure was to create a central Evolved Packet
     8Core (EPC) that all GENI sites may connect to using their own base stations
     9(eNBs) and user equipment (UEs) without having to congure individual EPCs.
     10
     11= 2.0 System Requirements =
     12
     13== 2.1 Hardware ==
     14
     15The machine chosen to run as the EPC should have at least 4 GB of RAM, 120
     16GB or more of disk storage, have a 64-bit Intel processor, and also have a 1G
     17Ethernet interface. As an example, at the Winlab Orbit Facility, the system is
     18currently congured on a server with two 160 GB hard drives. Two VLANS are
     19congured, one for the LTE Multipoint and the other for the WiMAX multi-
     20point.
     21
     22== 2.2 Software ==
     23
     24This EPC uses the Amarisoft LTE 100 software package, specically their EPC
     25solution(Version 2017-06-02). More details about this can be found at
     26https://www.amarisoft.com/software-enb-epc-ue-simulator/. The software can
     27run on any 64-bit Linux OS, and has been tested with Fedora versions 17-25 and
     28Ubuntu releases 12.x-16.x. The GENI LTE EPC is congured with an Ubuntu
     29Server 16.04 LTS install, running on Linux Kernel 4.4.
     30
     31= 3.0 Installation Procedure =
     32Before installation:
     33 * Make sure the system is up-to-date: 
     34   {{{
     35    sudo apt update && sudo apt upgrade
     36   }}}
     37 * Acquire the tarball of the licensed Amarisoft software package.
     38 * If a /opt/ directory is not already present, create one
     39Once these preliminary steps are complete, the following procedure can be fol-
     40lowed to make a clean installation:
     41 * Unzip the tarball in the /opt/ directory:
     42   {{{
     43    tar -C /opt -xf amarisfot-2017-06-02.tar.gz
     44   }}}
     45 * To automatically install all components of the Amarisoft software, simplyrun the install script:
     46   {{{
     47   cd /opt/amarisoft-2017-06-02
     48   sudo ./install.sh
     49   }}}
     50 * Right below this change, add the following to set the gtp payload mtu:
     51   {{{
     52   gtp_payload_mtu: 1500,
     53   }}}
     54
     55
     56 * Install SCTP tools if they are not present already on the system: {{{sudo apt install lkstcp-tools}}}
     57 *  Next, run the script that sets the NAT forwarding rules. This will enable IP forwarding (where interface-name is the name of the Ethernet interface): {{{sudo ./lte_init interface-name}}}
     58
     59
     60= Configuration =
     61
     62The GENI LTE EPC runs on the following IP: 10.3.0.250, ensure that this is
     63set as the static IP for the EPC. Confguration of the Amarisoft LTE software
     64is rather simple, and takes place all in one file, the "mme.cfg" file. First, make
     65a backup of mme.cfg in some convenient location. Then, edit the mme.cfg
     66fille in /opt/ in the following manner:
     67 * Change GTP address to the current outbound address, which is the IP of the EPC
     68
     69Before: {{{gtp_addr: "127.0.1.100",}}}
     70
     71After: {{{gtp_addr: "10.3.0.250",}}}