| 1 | = GENI LTE EPC DOCUMENTATION = |
| 2 | |
| 3 | = 1.0 Introduction = |
| 4 | |
| 5 | The purpose of this document is to outline the procedure needed to congure |
| 6 | the GENI Test LTE EPC located at Rutgers Orbit Winlab. The main goal that |
| 7 | was accomplished from this procedure was to create a central Evolved Packet |
| 8 | Core (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 | |
| 15 | The machine chosen to run as the EPC should have at least 4 GB of RAM, 120 |
| 16 | GB or more of disk storage, have a 64-bit Intel processor, and also have a 1G |
| 17 | Ethernet interface. As an example, at the Winlab Orbit Facility, the system is |
| 18 | currently congured on a server with two 160 GB hard drives. Two VLANS are |
| 19 | congured, one for the LTE Multipoint and the other for the WiMAX multi- |
| 20 | point. |
| 21 | |
| 22 | == 2.2 Software == |
| 23 | |
| 24 | This EPC uses the Amarisoft LTE 100 software package, specically their EPC |
| 25 | solution(Version 2017-06-02). More details about this can be found at |
| 26 | https://www.amarisoft.com/software-enb-epc-ue-simulator/. The software can |
| 27 | run on any 64-bit Linux OS, and has been tested with Fedora versions 17-25 and |
| 28 | Ubuntu releases 12.x-16.x. The GENI LTE EPC is congured with an Ubuntu |
| 29 | Server 16.04 LTS install, running on Linux Kernel 4.4. |
| 30 | |
| 31 | = 3.0 Installation Procedure = |
| 32 | Before 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 |
| 39 | Once these preliminary steps are complete, the following procedure can be fol- |
| 40 | lowed 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 | |
| 62 | The GENI LTE EPC runs on the following IP: 10.3.0.250, ensure that this is |
| 63 | set as the static IP for the EPC. Confguration of the Amarisoft LTE software |
| 64 | is rather simple, and takes place all in one file, the "mme.cfg" file. First, make |
| 65 | a backup of mme.cfg in some convenient location. Then, edit the mme.cfg |
| 66 | fille in /opt/ in the following manner: |
| 67 | * Change GTP address to the current outbound address, which is the IP of the EPC |
| 68 | |
| 69 | Before: {{{gtp_addr: "127.0.1.100",}}} |
| 70 | |
| 71 | After: {{{gtp_addr: "10.3.0.250",}}} |