Prerequisites

rApp SDK Source Code

For this training you will need BubbleRAN's rApp SDK which it is shared to all customers via Google Drive (soon to be available on Github for all customers). For running this lab you will need a Linux system with network access to your BubbleRAN MX-PDK. Ideally these labs should be performed on the control-plane node of your MX-PDK, e.g. via SSH.

Getting stated

Make sure you have the latest version of the ODIN operator

To check you may run:

brc list operator

If the operator is at its latest version, you should see as AtLatestKnown as STATUS. If the operator is not at its latest version we recommend updating it as explained here.

Make sure you have the Falcon version of the bubbleran composition model

The xApps that enforce the policies of these labs come from the bubbleran composition model. Install or update it with:

brc install model bubbleran

Then check that brc list model reports bubbleran with a CHART VERSION of 2.3.0 or newer.

Requires the Falcon bubbleran model

Before running this rApp training, make sure the bubbleran composition model is the Falcon version (2.3.0 or newer). With an older version, the xApps cannot register with the Falcon FlexRIC. For example, in the traffic steering lab brc extract logs ts.dynxapp-flexric.handover shows RAN Function not found, the xApp restarts in a loop, and the PolicyJob stays in Deploying.

Please refer to these steps to update your models.

Install common dependencies in Ubuntu

At least python3.12

# Update package lists
sudo apt update
# Install prerequisites
sudo apt install -y software-properties-common build-essential libssl-dev zlib1g-dev \
  libncurses5-dev libncursesw5-dev libreadline-dev libsqlite3-dev libgdbm-dev \
  libdb5.3-dev libbz2-dev libexpat1-dev liblzma-dev tk-dev libffi-dev
# Add the deadsnakes PPA (which provides newer Python versions)
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
# Install Python 3.12
sudo apt install -y python3.12 python3.12-venv

Create a virtual environment for rApp SDK

You may create a folder for running the rApp training labs

cd ~/
mkdir rapp-sdk
cd rapp-sdk
python3.12 -m venv rapp-sdk
source rapp-sdk/bin/activate
pip3 install br-rapp-sdk

If you are using VsCode, you can open the folder and select the created virtual environment as your Python interpreter. For more details on how to do that, please refer to the official VsCode documentation here.