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

1. Update the catalog source for the ODIN Operators Plane in the trirematics namespace. Paste this file into the home directory of your control-plane node and run the commands showed below to update the operator and the necessary composition models for the lab.

odin.yaml

apiVersion: operators.coreos.com/v1alpha1
kind: CatalogSource
metadata:
  name: odin-operators-plane
  namespace: trirematics
spec:
  displayName: ODIN Operators Plane
  image: hub.bubbleran.com/odin/operator-catalog:stable
  publisher: Trirematics
  secrets:
    - harbor-credentials
    - bubbleran-hub
  sourceType: grpc
  updateStrategy:
    registryPoll:
      interval: 5m

kubectl apply -f odin.yaml
brc install operator odin
brc install model bubbleran --set version=1.1.0

2. 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 python3.12-distutils

3. Create a virtual environment for rApp SDK. You should have in your system the rApp SDK shared to all customers.

tip

If you got the SDK as a compressed file. To unzip the file you can run:

tar -xvf br-rapp-sdk.tar.gz

cd /path/to/your/br-rapp-sdk
python3.12 -m venv venv
source venv/bin/activate
pip3 install .