Changes between Version 3 and Version 4 of Tutorials/4G5G/Inter Digital-5G


Ignore:
Timestamp:
Feb 28, 2020, 9:43:19 PM (4 years ago)
Author:
seskar
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • Tutorials/4G5G/Inter Digital-5G

    v3 v4  
    55
    66== Prerequisites ==
    7 In order to access the test bed, create a reservation and have it approved by the reservation service. Access to the resources are granted after the reservation is confirmed. Please follow the process shown on [wiki:cosmos_workflow the COSMOS work flow page] to get started.
     7In order to access the test bed, create a reservation and have it approved by the reservation service. Access to the resources are granted only after the reservation is confirmed. Please follow the process shown on [wiki:cosmos_workflow the COSMOS work flow page] to get started.
    88
    99== Set up ==
    10 
    11 Follow the steps below to gain access to this console and set up your node with an appropriate image.
    12  1. Sign up for a [https://cosmos-lab.org/portal-2/ COSMOS account]
    13  2. [Documentation/Short/CreateRes Create a resource reservation on sandbox 1]
    14  3. [Documentation/Short/Login Login into your reserved domain.]
    15  4. Load baseline_uhd.ndz on your resource. [Documentation/Short/LoadImage  - this is done via OMF commands.]
    16 
    17 When opening a terminal into console.sb1.cosmos-lab.org set up a tunnel from localhost:8080 to srv3-lg1.sb1.cosmos-lab.org:3005. This will be used by the browser to connect to a web server running on the server nodes. Alternatively, follow the instructions to establish a [wiki:/Documentation/VPN VPN tunnel] to the [wiki:/hardware/Domains/sb1 COSMOS sandbox 1].
     10The setup for experimenting with the InterDigital 5G-NR mmWave platform is shown in Figure 1.
     11[[Image(InterDigital-5G-NR-Tut.png)]]
     12-Two nodes for controling gNodeB and UE
     13-Three subnets as shown
     14-routing
     15Follow the steps below to gain access to the [wiki:/hardware/Domains/sb1 sandbox 1 console] and set up nodes with appropriate images.
     16 1. If you don't have one already, sign up for a [https://www.cosmos-lab.org/portal-2/ COSMOS account]
     17 1. [Documentation/Short/CreateRes Create a resource reservation] on sandbox 1
     18 1. Prepare 5G-NR status page access: either prepare [wiki:/Documentation/ssh_tyunnel ssh tunnel] thought console to gNodeB server node, port 3005 (i.e. map localhost:8080 to srv3-lg1.sb1.cosmos-lab.org:3005) or follow the instructions to establish a [wiki:/Documentation/VPN VPN tunnel] to the [wiki:/hardware/Domains/sb1 COSMOS sandbox 1]. This will be used by the browser to connect to a web server running on the server nodes.
     19 1. [Documentation/Short/Login Login] into sandbox 1 console (console.sb1.cosmos-lab.org) with two SSH sessions. The first session will be used for access to gNodeB while the second will be dedicated to handling UE.
     20 1. Load the images on the computing nodes: in each of the two session, start the [Documentation/Short/LoadImage  omf image loading] commands:
     21||  SSH ession 1 for gNodeB                        ||  SSH Session 2 for UE                   ||
     22|| {{{omf load -t srv3-lg1 -i ID-5G-gNB.ndz }}} || {{{omf load -t srv4-lg1 -i ID-5G-UE.ndz}}} ||
     23 1. Turn the server nodes and !InterDigital units on:
     24{{{
     25omf tell -a on -t srv3-lg1,srv4-lg1,rfdev2-1,rfdev2-2
     26}}}
    1827
    1928== Execution ==
    20 === Prepare the nodes ===
    21 
    22 
    23 === Configure Routing on compute nodes ===
     29=== Configure Routing on the two compute nodes ===
    2430
    2531 * Execute NR gNB setup script on srv3-lg1
    2632{{{
    27 userid@console:~$ ssh root@srv3-lg1.sb1.cosmos-lab.org
    28 root@srv3-lg1:~$ cd /home/native/NR/scripts
    29 root@srv3-lg1:/home/native/NR/scripts# ./setup_bs.sh
     33userid@console:~$ ssh root@srv3-lg1
     34root@srv3-lg1:~$ ./setup_gNodeB.sh
    3035}}}
    3136
    3237 * Execute NR UE setup script on srv4-lg1.
    3338{{{
    34 userid@console:~$ ssh root@srv4-lg1.sb1.cosmos-lab.org
    35 root@srv4-lg1:~$ cd /home/native/NR/scripts
    36 root@srv4-lg1:/home/native/NR/scripts# ./setup_ue.sh
    37 }}}
    38 
    39 === Start modem executables ===
    40  * SSH to the gNB MPU from “srv3-lg1.sb1.cosmos-lab.org”
    41 {{{
    42 root@srv3-lg1:~# ssh root@192.168.1.2
    43 (when prompted for a password use: root)
    44 Start the NR gNB L1 & L23 executables
    45 root@NR-SW-MPU:~# ./start_all.sh
    46 }}}
    47 
    48  * SSH to the UE MPU from “srv4-lg1.sb1.cosmos-lab.org”
    49 {{{
    50 root@srv4-lg1:~# ssh root@192.168.2.3
    51 (when prompted for a password use: root)
    52 Start the NR UE L1 & L23 executables
    53 root@NR-SW-MPU:~# ./start_all.sh
     39userid@console:~$ ssh root@srv4-lg1
     40root@srv4-lg1:~$ ./setup_UE.sh
    5441}}}
    5542
    5643The NR Platform will automatically “connect” a link between the gNB and UR.  This can be verified via the NR GUI
    5744
    58 === Halt the modem executables ===
    59 
    60 The L1 executable should be stopped before terminating the L23 executable
    61 {{{
    62 root@NR-SW-MPU:~# ./stop_L1.sh
    63 }}}
    64 
    65 In the session used to initially start the executables (gNB or UE) enter “ctrl C” to stop the L23 executable
    66 
    67 
    6845=== NR GUI Setup & Instructions ===
    6946Note that the GUI web server has already been started during Linux startup.
    70 
    71 !!!!! ADD INstructions for ssh tunneling and/or VPN !!!!
    72 
     47Open the browser and point it at '''http://localhost:8080''' (if using ssh tunneling) or at '''http://srv3-lg1.sb1.cosmos-lab.org:3005'''
    7348=== Sending iperf data between the gNB and UE ===
    7449The following commands are provided as an example of how to send Downlink iperf data traffic on the NR 28GHz mmW OTA link via the compute machines that are attached to the gNB and UE platforms
    7550
    76  * Open the 3rd “srv4-lg1” console session to the UE
     51 * In the UE console session start the iperf server
    7752{{{
    78 console> ssh root@srv4-lg1.sb1.cosmos-lab.org
    79 root@srv4-lg1:~#iperf3 -s -i 1
     53root@srv4.lg1:~$ iperf3 -s -i 1
    8054}}}
    8155
    82  * Open the 3rd “srv3-lg1” console session to the gNB
     56 * In the gNodeB session strat the iperf client
    8357{{{
    84 console> ssh root@srv3-lg1.sb1.cosmos-lab.org
    85 root@srv3-lg1:~# iperf3 -c 192.168.2.4 -i 1 -u -b 86M -l 1472 -t 3600
     58root@srv3-lg1:~# iperf3 -c 192.168.2.1 -i 1 -u -b 86M -l 1472 -t 3600
    8659}}}
    8760
    8861=== Analyze the NR link performance via the NR GUI ===
    8962
     63
    9064[[Image(NR-gui.png)]]
    9165