Steps for setting up OAI EPC on orbit

This wiki page expands on the following steps from the eurecom wiki, to customize the sim card info and hostnames.

1. Hardware
   1. The EPC should operate on a bare metal PC, VM, or container. Restrictions are due to kernel support, not timing.
2. Operating system
   1. Testing has been done on Ubuntu 14.04 64 bit. Ubuntu 16.04 may work, but has not been tested.
3. Kernel
   1. More info at: ​https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/OpenAirKernelMainSetup
   2. We need the GTP tunnel module, from either kernel 4.8 (untested) or a custom compiled 4.7.x
      1. install kernel 4.7.7

         git clone https://gitlab.eurecom.fr/oai/linux-4.7.x.git
         cd linux-4.7.x
         sudo dpkg -i linux-headers-4.7.7-oaiepc_4.7.7-oaiepc-10.00.Custom_amd64.deb linux-image-4.7.7-oaiepc_4.7.7-oaiepc-10.00.Custom_amd64.deb
         

   3. issues with changing kernels on xen vm
      1. Depending on the configuration of the hypervisor, the guest OS may not be able to select a different kernel from that used for provisioning. The image below was built on a bare-metal pc, and then migrated to a VM successfully.
4. hostnames
   1. append the following lines to /etc/hosts:

      127.0.1.1 nano.orbit-lab.org nano
      127.0.1.1 hss.orbit-lab.org hss
      

   2. set /etc/hostname to nano
   3. hostnamectl may be a workaround
   4. to check, you must use getent hosts name
      1. getent uses gethostbyname, while host and nslookup query DNS directly
   5. GENI workaround
      1. on every boot:
         1. append to etc/hosts
         2. delete etc/hostname
         3. run hostnamectl set-hostname nano
         4. logout and back in
5. use script to append items to db
   1. mmeidentity for user must match index of mme used
   2. imsi specified for both user and pdn
   3. specify user key with UNHEX function
   4. edit line at bottom of hss.config to enable 001 01 plmn
      1. fqdn defined in spec
6. GENI
   1. EPC URN: urn:publicid:IDN+instageni.rutgers.edu+image+ch-geni-net:OAIEPCOrbit
   2. EPC fixed?: urn:publicid:IDN+instageni.rutgers.edu+image+ch-geni-net:oaiepc477
   3. newest EPC: urn:publicid:IDN+instageni.rutgers.edu+image+ch-geni-net:epc447scripted
      1. URL: https://www.instageni.rutgers.edu/image_metadata.php?uuid=b300f9dc-0611-11e7-a074-000000000000
   4. eNB
      1. URN: urn:publicid:IDN+instageni.rutgers.edu+image+ch-geni-net:OAIeNBRutgers
      2. URL: https://www.instageni.rutgers.edu/image_metadata.php?uuid=6844496a-9d2a-11e6-90f4-000000000000
7. RCC/RRU:
   1. EPC needs link on 10.3, for vlan access
   2. EPC needs tunnel endpoint on 10.3, or via landing1, for demo sctp
   3. RCC needs 10.3 link to mme, as well as link to RRU, in this case tunne, 10.10, or 10.40
   4. RRU needs 10.3 to mme, as well as link to RCC (need to work on this, two tunnels?
8. issues:
   1. Cannot seem to connect to vlan3701, fia-xia, 10.3.x.x
      1. vlan is now named GENI-LTE-Multipoint
   2. local connection to vlan 60, grid, 10.10
   3. need to create connection to vlan 70, outdoor, 10.30
9. MTU
   1. up to 12 octets for GTP-U header, advertise mtu 1460-12 = 1448
   2. 12 octets for l2tp + 20 for ip, 8 for udp, 40 total. tunnel mtu 1460.
10. resources
    1. ​https://remote-lab.net/linux-l2tp-ethernet-pseudowires
    2. ​http://groups.geni.net/geni/wiki/GeniNetworkStitchingSites
    3. ​http://groups.geni.net/geni/wiki/ConnectivityHome