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 follows:

brc remove operator odin
brc install operator odin

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

brc install model bubbleran --set version=2.2.1

danger

Before running this xApp training you should make sure ALL your composition models are up-to-date.

Please refer to these steps to do so.

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