Getting Started with InterDigital 5G NR Performance System

Desciption

In this tutorial we'll demonstrate how to use 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 the COSMOS work flow page to get started.

Set up

The setup for experimenting with the Inter Digital 5G-NR mmWave platform is shown in Figure 1.

TODDO Experimetn Description:

• gNodeB and UE
• Two nodes for controling them
• Three subnets as shown
• routing

Follow the steps below to gain access to the sandbox 1 console and set up nodes with appropriate images.

1. If you don't have one already, sign up for a ​COSMOS account
2. Create a resource reservation on sandbox 1
3. Prepare 5G-NR status page access: either prepare 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 VPN tunnel to the COSMOS sandbox 1. This will be used by the browser to connect to a web server running on the server nodes.
4. 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.
5. Load the images on the computing nodes: in each of the two session, start the 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 NR platform devices 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 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

The two scripts are shown in the table below:

setup_gNodeB.sh

#!/bin/bash # Start the gNodeB on the MPU sshpass -p "root" ssh -o StrictHostKeyChecking=no root@192.168.1.2 "sh /home/root/start_all.sh &" # Turn on routing echo 1 > /proc/sys/net/ipv4/ip_forward sysctl -w net.ipv4.ip_no_pmtu_disc=1 # Add rotuing for the two subnets "behind" the gNodeB ip route add 192.168.2.0/24 via 192.168.1.2 ip route add 192.168.3.0/24 via 192.168.1.2 # and configure NAT for them iptables -t nat -A POSTROUTING -o eth1 -j MASQUERADE iptables -A FORWARD -i eth1 -o eth0 -m state --state RELATED,ESTABLISHED -j ACCEPT iptables -A FORWARD -i eth0 -o eth1 -j ACCEPT

setup_UE.sh

#!/bin/bash # Start the UE on the MPU sshpass -p "root" ssh -o StrictHostKeyChecking=no root@192.168.2.1 "sh /home/root/start_all.sh &" # Turn on routing echo 1 > /proc/sys/net/ipv4/ip_forward sysctl -w net.ipv4.ip_no_pmtu_disc=1 # Route all internal 5G traffic through MPU ip route add 192.168.1.0/24 via 192.168.2.1 dev eth0 # Except for the testbed bound traffic ip r add 10/8 dev eth1 # Everything else goes over 5G ink ip r add default via 192.168.1.1

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