close Warning: Can't synchronize with repository "(default)" (/common/SVN/wimax does not appear to be a Subversion repository.). Look in the Trac log for more information.

Changes between Version 13 and Version 14 of cLTE/eSoftware/cEpc


Ignore:
Timestamp:
Jun 22, 2017, 2:32:02 PM (3 years ago)
Author:
luisanevers
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • cLTE/eSoftware/cEpc

    v13 v14  
    1313== GENI OAI ePC ==
    1414
    15 The deployment of the BBN GENI ePC was captured to provide an outline of the required installation, configuration and run-time requirements for an ePC/eNobeB setup on a GENI resource.  See the '''[http://groups.geni.net/geni/wiki/GENILTE/LTEDeployment OpenAirInterface ePC GENI Site Deployment]''' page for a detailed look at steps required to add ePC/eNobeB  resources to the GENI LTE multi-point VLAN and enabling the ability to share your site ePC/eNobeB setup with other GENI sites.
     15The deployment of the BBN GENI ePC was captured to provide an outline of the installation, configuration and run-time requirements for an ePC/eNobeB setup on a GENI resource.  See the '''[http://groups.geni.net/geni/wiki/GENILTE/LTEDeployment OpenAirInterface ePC GENI Site Deployment]''' page for a detailed look at steps required to add ePC/eNobeB  resources to the GENI LTE multi-point VLAN and enabling the ability to share your site ePC/eNobeB setup with other GENI sites.
    1616
    17 __Note:__ For GENI deployments it is strongly suggested that a dedicate bare metal node be reserved.  Testing on VM has consistently shown that VM are not a viable selection for running the OAI ePC software.
     17== ePC Installation Guidelines ==
    1818
    19 == Preliminary  ePC Installation Guidelines ==
     19Instructions below highlight guidelines for installing the OAI ePC on a GENI resource. See the  [http://groups.geni.net/geni/wiki/GENILTE/LTEDeployment OpenAirInterface ePC GENI Site Deployment] page for detailed instructions.
    2020
    21 Instructions below were initially provided as a guide to installing the OAI ePC, for latest verified approach to using GENI ePC see the  [http://groups.geni.net/geni/wiki/GENILTE/LTEDeployment OpenAirInterface ePC GENI Site Deployment] page.
     21==== ePC Host Configuration ====
    2222
    23 ==== Machine/VM Configuration ====
    24 The !OpenAirInterface ePC should operate on a bare metal PC, VM, or container. Restrictions are due to kernel support, not timing.
     23For GENI deployments it is strongly suggested that a dedicate bare metal node be reserved.  Testing on VM has consistently shown that VM are not a viable selection for running the OAI ePC software in GENI. See the [http://groups.geni.net/geni/wiki/GENILTE/LTEDeployment#GetGENIResource Get GENI Resource] instructions to request a raw pc for your installation.  A reference request RSpec [https://raw.githubusercontent.com/GENI-NSF/geni-support/master/wireless/lte-raw-pc-default-image.rspec lte-raw-pc-default-image.rspec] is provided as an example, which must be edit to your your Site specific information.
    2524
    2625[[NewsFlashStart]]
     
    3029}}}
    3130This wiki page expands on the following steps from the eurecom wiki:
    32 * [https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/OpenAirKernelMainSetup Kernel Requirements for RAN]
     31* [https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/home OpenAirInterface Project]
    3332* [https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/GetSources The OpenAirInterface repository]
     33* [https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/AutoBuild Building OAI Executables]
    3434* [https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/HowToConnectCOTSUEwithOAIeNBNew How to Connect OAI eNB]
    3535[[NewsFlashEnd]]
    3636
    3737===== Operating system =====
    38 Testing has been done on Ubuntu 14.04 64 bit and Ubuntu 16.04. However, OAI ePC requires the GTP tunnel module which is available from kernel > 4.8. You can obtain this via the ubuntu HWE kernels.
    39 {{{
    40   apt-get install linux-image-generic-hwe-16.04
    41 }}}
    42 On GENI xen vm 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 reference image was built on a bare-metal pc, and then migrated to a VM successfully.
     38
     39Testing has been done on Ubuntu 14.04 64 bit and Ubuntu 16.04. However, OAI ePC requires the GTP tunnel module which is available for Linux kernel 4.8 and higher. On GENI a kernel 4.8 must be specifically requested, as it is not part of the default upgrade path.  See the [http://groups.geni.net/geni/wiki/GENILTE/LTEDeployment#InstaGENISiteSoftwareInstallation Installing 4.8 Kernel on InstaGENI ePC Resource] instruction for details.
     40 
     41===== Installing OAI ePC Software =====
     42The page [https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/AutoBuild Building OAI Executables] provides instructions for building the building the OAI eNB and ePC software.  Instruction followed at the BBN for the building the ePC are captured in the [http://groups.geni.net/geni/wiki/GENILTE/LTEDeployment#InstallingOAIePCSoftware  Installing OAI ePC Software] section. Note, the '''develop''' branch was used in the effort.
    4343
    4444===== Configuration =====
     45
     46Configuration changes must be made to the following ePC files:
     47        * openair-cn/etc/acl.conf
     48        * openair-cn/etc/hss.conf
     49        * openair-cn/etc/hss_fd.conf
     50        * openair-cn/etc/mme.conf
     51        * openair-cn/etc/mme_fd.conf
     52        * openair-cn/etc/spgw.conf
     53
     54Numerous changes are required to make the installation specific to your site, a "git diff" of the configuration used at BBN can be found in the http://groups.geni.net/geni/wiki/GENILTE/LTEDeployment#ePCConfiguration ePC Configuration] section.  Also highlighted below are the required changes:
    4555
    4656  A. hostnames
     
    8393   * edit fqdns at bottom of hss.config to enable 001 01 plmn
    8494    *. fqdn defined in spec, but you can just replace 208 93 with 001 001. #BOTH MUST BE 3 DIGITS
    85 1. generate FD keys
     95 
     961. Once modification as completed, generate the FD keys
    8697 1. in {{{openair-cn/SCRIPTS}}}
    8798 1. {{{./check_hss_s6a_certificate /usr/local/etc/oai/freeDiameter/ hss.orbit-lab.org}}}
    8899 1. {{{./check_mme_s6a_certificate /usr/local/etc/oai/freeDiameter/ nano.orbit-lab.org}}}
    89 1. Compile and install hss, mme, and spgw
     100
     101
     1021. Compile and install hss, mme, and spgw with your modifications:
    90103{{{
    91104cd YOUR_openair-cn_DIRECTORY
     
    95108./build_spgw -I #Need to run only once
    96109}}}
     110
    971111. set up DB for hss
    98112 1. {{{./run_hss -i ~/openair-cn/SRC/OAI_HSS/db/oai_db.sql #Run only once to install database}}}