Changes between Version 6 and Version 7 of Tutorials/g0WmLTE/Tutorial4-OAI/Tutorial0


Ignore:
Timestamp:
Jan 7, 2017, 1:20:12 AM (8 years ago)
Author:
msherman
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • Tutorials/g0WmLTE/Tutorial4-OAI/Tutorial0

    v6 v7  
    1 === Under Construction ===
    21=== Basic OAI Tutorial ===
    32
     
    54
    65==== Objective ====
    7 This objective of this tutorial is to establish a LTE connection between the SDR based  UE and eNB. In order to that we need to prepare configuration files on two nodes in sandbox 1, node1-1 and node1-2.
     6This objective of this tutorial is to establish a LTE connection between the SDR based  UE and eNB.
    87
     8==== Quickstart Option
     9We 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.
     10
     11[[CollapsibleStart(If you intend to use graphical user interface please make sure to install appropriate tools on your local machine and configure X11 forwarding.)]]
     12  [[Include(Documentation/bAccountManagement/fRemoteX)]]
     13  [[CollapsibleEnd]]
    914------------------------------
     15The image was built following the tutorial available at:
     16[https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/HowToConnectOAIENBWithOAIUEWithoutS1Interface OAI Gitlab tutorial, no S1 interface]
     17------------------------
    1018
    11 The image was built following the tutorial available at:
    12 [https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/HowToConnectOAIENBWithOAIUEWithoutS1Interface OAI no S1]
    13 
    14 
    15 ==== Prepare the nodes ====
     19===== Prepare the nodes
    1620
    17211. Load the two images with the OAI code to nodes 1-1 and 1-2. This enables running the experiment with no compilation needed.
     
    2024 1. Load the UE image to node1-2.
    2125  1. {{{omf load -t node1-2 -i mf-oai-ue.ndz}}}
    22 1. Turn ON the nodes that successfully imaged (give them some time and check their status with '''omf stat''' before proceeding).
    23 
    24 ==== Execute the experiment ====
    25 
    26 
    27 [[CollapsibleStart(If you intend to use graphical user interface please make sure to install appropriate tools on your local machine and configure X11 forwarding.)]]
    28   [[Include(Documentation/bAccountManagement/fRemoteX)]]
    29   [[CollapsibleEnd]]
    30 ------------------------
    31 
    32 ==== Quickstart Option ====
    33 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.
    34 
    35 1. To proceed, after having a reservation, load the following image.
    36  * {{{omf load -t node1-1,node1-2 -i oai-dev.ndz}}}
    37  * The nodes will automatically turn off when imaging is completed.
    38261. Turn the nodes on.
    39  * {{{omf tell -a on -t node1-1,node1-2}}}
     27 1. {{{omf tell -a on -t node1-1,node1-2}}}
    40281. Open a terminal to each node. You must enable X11 Forwarding to see the GUI and statistics screens.
    4129 1. You will need at lease one terminal per node, for the statistics screens. Even more if you want to run additional commands. For details, refer to the Remote Graphical Access section.
    42 1. On the first node, execute script {{{./CompandRuneNB}}}
    43 1. On the second node, execute script {{{./CompandRunUE}}}
    44 1. For subsequent runs, execute {{{./runeNB}}} or {{{./runUE}}} instead, to avoid recompiling.
     30
     31===== Execute the experiment
     32
     331. On node1-1, execute script {{{./run_enb.sh}}}
     34 1. Wait for the visualization to appear, it should look like this:
     351. On node1-2, execute script {{{./run_ue.sh}}}
     36 1. Wait for the visualization to appear, it should look like this:
    45371. These scripts will create interface {{{oai0}}} and assign an address.
    4638 1. Use {{{ifconfig}}} or {{{ip a}}} to see the address assigned.
    47  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.
     39 1. By default the eNB has address 10.0.1.1, and the UE has address 10.0.1.9, but you should double check.
    48401. You should be able to ping from one node to the other on these addresses.
    4941 1. From UE, {{{ping 10.0.1.1}}} or to see live statistics {{{mtr 10.0.1.1}}}
     42 1. As you send traffic, you should see the visualization change.
    5043
    51 In your terminals, you will see the following screens upon successful script execution.
    52 
    53 [[Image(eNB.png, width=600)]] [[Image(UE.png, width=600)]]
    54 
    55 ==== OAI eNB in ORBIT
    56 UNDER DEVELOPMENT
    57 
    58 1. Load image lte-edge.ndz to a node with a b210
    59  1. This can be found from the status page
    60 1. Turn the node on
    61 1. SSH to the node
    62 1. {{{ cd /opt }}}
    63 1. Run {{{ ./setup.sh --build_enb_ue }}}
    64 1. Edit the configuration file to match the needed IP using the editor of your choice (example vim)
    65  1. {{{ vim ./conf/enb.band25.tm1.usrpb210.conf }}}
    66  1. The MME ip address is on the line
    67 {{{
    68 mme_ip_address      = ( { ipv4       = "10.3.0.21";
    69 }}}
    70   1. Do not change this unless you are using a custom MME, rather than the ORBIT hosted one, or are tunneling.
    71  1. Set the following four lines to match the interface you will use to connect to the MME. In this example it is set to use eth1 on node8-7.grid.orbit-lab.org.
    72 {{{
    73 ENB_INTERFACE_NAME_FOR_S1_MME            = "eth0";
    74 ENB_IPV4_ADDRESS_FOR_S1_MME              = "10.40.4.5/16";
    75 ENB_INTERFACE_NAME_FOR_S1U               = "eth0";
    76 ENB_IPV4_ADDRESS_FOR_S1U                 = "10.40.4.5/16";
    77 }}}
    78 1. Run the eNB {{{ ./openairinterface5g/cmake_targets/lte_build_oai/build/lte-softmodem -O ./conf/enb.band25.tm1.usrpb210.conf }}}
    79  1. Some options to append
    80   1. -d : shows visual displays
    8144 
    8245