Prerequisites

Open RAN Studio (ORS) could be deployed on a local cluster or on a public cloud provider. The Bronze release officially supports installation of ORS on the following environments:

• Single Node: Using microk8s on a single machine.
• Multi Node: Using kubeadm on multiple machines.
• Public Cloud: Using Terraform over Google Kubernetes Engine (GKE).

The Public Cloud option is the most useful for large scale training and education. Contact BubbleRAN for ordering the ORS software and setting up the environment.

CLI Initialization

Use the documentation from the Tutorials for more information on how to set up the CLI.

For using the CLI with GKE, you need retrieve the GKE credentials using the following command:

br-t9s.gcloud auth login

and login with your Google account attached to the GKE project with at least cluster-admin permissions. Then get the kubecofig file using the following command:

br-t9s.gcloud container clusters get-credentials {cluster-name} --region {region} --project {project-name}

Wireshark Setup

These labs need a Wireshark version at minimum 3.6 to be installed on your machine.

OAI T-Tracer configurations

1. In the toolbar menu, from Edit choose Preferences.
2. In the preference window, unroll Protocols section.
3. Go to UDP protocol and activate Try heuristic sub-dissectors first.
4. Go to MAC-LTE protocol and activate Try Heuristic LTE-MAC over UDP framing if this option is present.
5. Go to MAC-NR protocol and select both options Attempt to decode BCCH, PCCH and CCCH data using NR RRC dissector and Attempt to dissect LCID 1-3 as srb1-3.
6. Under the same section, for Source of LCID -> drb channel settings choose option From static table.
7. Then click on the Edit... button of LCID -> DRB Mappings Table.
8. In the new window, click on + and choose LCID 4, DRBID 1, UL RLC Bearer Type AM, SN Len=18.
9. In the same window, click on + again and choose LCID 4, DRBID 1, DL RLC Bearer Type AM, SN Len=18.
10. Then click OK to save the changes.
11. Now, go to RLC-NR protocol and select 18-bit SN for both Call PDCP dissector for UL DRB PDUs and Call PDCP dissector for DL DRB PDUs.
12. In the same section, select Call RRC dissector for CCCH PDUs.
13. Now, go to PDCP-NR protocol and enable the following options:
    • Show uncompressed User-Plane data as IP
    • Show unciphered Signalling-Plane data as RRC
    • Attempt to decipher Signalling (RRC) SDUs
    • Attempt to decipher User-Plane (IP) SDUs
    • Attempt to check integrity calculation
14. In the E2AP protocol section, change the port number to 36421.
15. You are done with the preferences and you can click OK to save the changes.
16. In the toolbar menu, from Analyze choose Enabled Protocols.
17. In the enabled protocols window, search for the following protocols and activate them:
    • MAC
    • MAC-LTE
    • mac_lte_udp
    • MAC-NR
    • mac_nr_udp
    • RLC
    • rlc_udp
    • RLC-LTE
    • rlc_lte_udp
    • RLC-NR
    • rlc_nr_udp
    • PDCP-LTE
    • pdcp_lte_udp
    • PDCP-NR
    • pdcp_nr_udp
    • S1AP
    • NGAP
    • NAS-EPS
    • NAS-5GS

SRS configurations

1. In the toolbar menu, from Edit choose Preferences.
2. In the preference window, unroll Protocols section.
3. Under the DLT_USER protocol, click on Edit... button.
4. In the new window, click on + and add the following entries as the table below:
5. Click OK to save the changes.
6. Under protocol NAS-5GS, select Try to detect and decode 5G-EA0 ciphered messages.
7. Click OK to save the changes.

DLT	Payload Protocol
149	udp
148	nas-eps
150	s1ap
152	ngap
156	gtp
153	e1ap
154	f1ap
155	e2ap