= Getting Started with !InterDigital 5G NR Performance System =

=== Desciption ===
In this tutorial we'll demonstrate how to use [wiki:/hardware/SubSystems/IDPerformance InterDigital 5G-NR Performance platform]

== Prerequisites ==
In 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. 

== Set up ==
The setup for experimenting with the InterDigital 5G-NR mmWave platform is shown in Figure 1.
[[Image(InterDigital-5G-NR-Tut.png)]]
-Two nodes for controling gNodeB and UE
-Three subnets as shown
-routing 
Follow the steps below to gain access to the [wiki:/hardware/Domains/sb1 sandbox 1 console] and set up nodes with appropriate images. 
 1. If you don't have one already, sign up for a [https://www.cosmos-lab.org/portal-2/ COSMOS account]
 1. [Documentation/Short/CreateRes Create a resource reservation] on sandbox 1
 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.
 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. 
 1. Load the images on the computing nodes: in each of the two session, start the [Documentation/Short/LoadImage  omf image loading] commands:
||  SSH ession 1 for gNodeB                        ||  SSH Session 2 for UE                   ||
|| {{{omf load -t srv3-lg1 -i ID-5G-gNB.ndz }}} || {{{omf load -t srv4-lg1 -i ID-5G-UE.ndz}}} ||
 1. Turn the server nodes and !InterDigital units on:
{{{
omf tell -a on -t srv3-lg1,srv4-lg1,rfdev2-1,rfdev2-2
}}}

== Execution ==
=== Configure Routing on the two compute nodes ===

 * Execute NR gNB setup script on srv3-lg1
{{{
userid@console:~$ ssh root@srv3-lg1
root@srv3-lg1:~$ ./setup_gNodeB.sh
}}}

 * Execute NR UE setup script on srv4-lg1. 
{{{
userid@console:~$ ssh root@srv4-lg1
root@srv4-lg1:~$ ./setup_UE.sh
}}}

The NR Platform will automatically “connect” a link between the gNB and UR.  This can be verified via the NR GUI

=== NR GUI Setup & Instructions ===
Note that the GUI web server has already been started during Linux startup.
Open the browser and point it at '''http://localhost:8080''' (if using ssh tunneling) or at '''http://srv3-lg1.sb1.cosmos-lab.org:3005'''
=== Sending iperf data between the gNB and UE ===
The 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

 * In the UE console session start the iperf server
{{{
root@srv4.lg1:~$ iperf3 -s -i 1
}}}

 * In the gNodeB session strat the iperf client 
{{{
root@srv3-lg1:~# iperf3 -c 192.168.2.1 -i 1 -u -b 86M -l 1472 -t 3600
}}}

=== Analyze the NR link performance via the NR GUI ===


[[Image(NR-gui.png)]]