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


Ignore:
Timestamp:
Feb 29, 2020, 2:03:05 PM (4 years ago)
Author:
seskar
Comment:

—

Legend:

Unmodified
Added
Removed
Modified

  • Tutorials/4G5G/Inter Digital-5G

    v6 v7  
    11= Getting Started with !InterDigital 5G NR Performance System =
    22
    3 === Desciption ===
    4 In this tutorial we'll demonstrate how to use [wiki:/hardware/SubSystems/IDPerformance InterDigital 5G-NR Performance platform]
     3[[TOC()]]
     4
     5== Description ==
     6In this tutorial we'll demonstrate how to use [wiki:/hardware/SubSystems/IDPerformance InterDigital 5G-NR Performance platform]. The setup for the experiment is shown in Figure 1.
     7
     8[[Image(InterDigital-5G-NR-Tut.png, 800px)]]
     9
     10TODDO Setup Description:
     11 * gNodeB and UE
     12 * Two nodes for controling them
     13 * Three subnets as shown
     14 * routing
    515
    616== Prerequisites ==
    717In 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.
    818
    9 == Set up ==
    10 The setup for experimenting with the InterDigital 5G-NR mmWave platform is shown in Figure 1.
    11 
    12 [[Image(InterDigital-5G-NR-Tut.png, 800px)]]
    13 
    14 TODDO Experimetn Description:
    15  * gNodeB and UE
    16  * Two nodes for controling them
    17  * Three subnets as shown
    18  * routing
     19== Tutorial Setup ==
    1920 
    2021Follow the steps below to gain access to the [wiki:/hardware/Domains/sb1 sandbox 1 console] and set up nodes with appropriate images.
    … …  
    2425 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.
    2526 1. Load the images on the computing nodes: in each of the two session, start the [Documentation/Short/LoadImage  omf image loading] commands:
    26 ||  SSH ession 1 for gNodeB                        ||  SSH Session 2 for UE                   ||
    27 || {{{omf load -t srv3-lg1 -i ID-5G-gNB.ndz }}} || {{{omf load -t srv4-lg1 -i ID-5G-UE.ndz}}} ||
     27||  SSH session 1 for gNodeB                        ||  SSH Session 2 for UE                   ||
     28|| {{{omf load -t srv3-lg1 -i ID-5G-gNB.ndz -r 50 }}} || {{{omf load -t srv4-lg1 -i ID-5G-UE.ndz -r 50}}} ||
    2829 1. Turn the server nodes and NR platform devices on:
    2930{{{
    … …  
    3132}}}
    3233   
    33 == Execution ==
     34== Experiment Execution ==
    3435
    3536=== Configure Routing on the two compute nodes ===
    … …  
    3940userid@console:~$ ssh root@srv3-lg1
    4041root@srv3-lg1:~$ ./setup_gNodeB.sh
     42---------------
     43Make sure to start the gNodeB modem on the MPU by logging in with:
     44sshpass -p root ssh -o StrictHostKeyChecking=no root@192.168.1.2
     45and running:
     46root@NR-SW-MPU-gNB:~# ./start_all.sh
     47----------------
     48net.ipv4.ip_no_pmtu_disc = 1
     49root@srv3-lg1:~#
    4150}}}
    4251
    … …  
    4756}}}
    4857
    49 The two scripts will start the appropriate firmware on both NR Platform devices and setup routing to push the test traffic from the server that is attached to UE through the 5G-NR link. The NR Platform will automatically “connect” a link between the gNB and UR. This can be verified via the NR GUI
     58The two scripts setup routing to push the test traffic from the server that is attached to UE through the 5G-NR link.
    5059
     60[[CollapsibleStart(Routing Scripts)]]
    5161The two scripts are shown in the table below:
    5262
    … …  
    5868{{{
    5969#!/bin/bash
    60 # Start the gNodeB on the MPU
    61 sshpass -p "root" ssh -o StrictHostKeyChecking=no root@192.168.1.2 "sh /home/root/start_all.sh &"
    62 # Turn on routing
     70echo "---------------"
     71echo "Make sure to start the gNodeB modem on the MPU by logging in with:"
     72echo "sshpass -p "root" ssh -o StrictHostKeyChecking=no root@192.168.1.2"
     73echo "and running:"
     74echo "root@NR-SW-MPU-gNB:~# ./start_all.sh"
     75echo "----------------"
     76# Turn on routing
    6377echo 1 > /proc/sys/net/ipv4/ip_forward
    6478sysctl -w net.ipv4.ip_no_pmtu_disc=1
    … …  
    93107}}}
    94108}}}
     109[[CollapsibleEnd]]
    95110
    96 === NR GUI Setup & Instructions ===
     111=== Start services on the two MPUs ===
     112
     113 1. ssh into gNodeB MPU at 192.168.1.2 with username "root" and password "root" and execute the setup script "start_all.sh":
     114{{{
     115root@srv3-lg1:~# ssh root@192.168.1.2
     116root@192.168.1.2's password:
     117root@NR-SW-MPU-gNB:~# ./start_all.sh
     118root@NR-SW-MPU-gNB:~# metal: info:      metal_uio_dev_open: No IRQ for device 3ed80000.shm.
     119
     120root@NR-SW-MPU-gNB:~# exit
     121logout
     122Connection to 192.168.1.2 closed.
     123root@srv3-lg1:~#
     124}}}
     125 1. ssh into UE MPU at 192.168.2.1 with username "root" and password "root: and execute the setup script "start_all.sh":
     126{{{
     127root@srv4-lg1:~# ssh 192.168.2.1
     128root@192.168.2.1's password:
     129root@NR-SW-MPU-UE:~# ./start_all.sh
     130root@NR-SW-MPU-UE:~# metal: info:      metal_uio_dev_open: No IRQ for device 3ed80000.shm.
     131
     132root@NR-SW-MPU-UE:~# exit
     133logout
     134Connection to 192.168.2.1 closed.
     135root@srv4-lg1:~#
     136}}}
     137
     138The two scripts will start the appropriate firmware on both NR Platform devices. The NR Platform will automatically “connect” a link between the gNB and UR. This can be verified via the NR GUI
     139
     140=== GUI Setup & Instructions ===
     141
    97142Note that the GUI web server has already been started during Linux startup.
    98 Open the browser and point it at '''http://localhost:8080''' (if using ssh tunneling) or at '''http://srv3-lg1.sb1.cosmos-lab.org:3005'''
     143Open the browser and point it at '''http://localhost:8080''' (if using ssh tunneling) or at '''http://srv3-lg1.sb1.cosmos-lab.org:3005''' if using VPN.
     144
    99145=== Sending iperf data between the gNB and UE ===
     146
    100147The 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
    101148
    … …  
    112159=== Analyze the NR link performance via the NR GUI ===
    113160
    114 
    115161[[Image(NR-gui.png)]]
    116162
     163== Shutting Down Resources ==
     164
     165Turn off the server nodes and NR platform devices:
     166{{{
     167omf tell -a offh -t srv3-lg1,srv4-lg1,rfdev2-1,rfdev2-2
     168}}}