Skip to main content

Prerequisites

xApp SDK Source Code

For this training you will need BubbleRAN's xApp 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. Install common dependencies in Ubuntu: (at least python3.8)
sudo apt install libsctp-dev python3 cmake-curses-gui python3-dev pkg-config libconfig-dev libconfig++-dev python3-pip
  1. Install MySQL as a storage for xApps:
sudo apt install libmysqlclient-dev mysql-server
  1. Install python packages
pip3 install tabulate

In order to obtain the BubbleRAN's xApp SDK through Github the user can clone the repository:

git clone https://github.com/bubbleran/xapp_sdk.git

The repository has the following structure:

.
β”œβ”€β”€ CMakeLists.txt
β”œβ”€β”€ conf
β”‚ β”œβ”€β”€ default.conf
β”‚ β”œβ”€β”€ README.md
β”‚ β”œβ”€β”€ update_conf.sh
β”‚ β”œβ”€β”€ xapp_all_sm.conf
β”‚ β”œβ”€β”€ xapp_cust_sm.conf
β”‚ └── xapp_oran_sm.conf
β”œβ”€β”€ include
β”‚ └── src
β”œβ”€β”€ labs
β”‚ β”œβ”€β”€ CMakeLists.txt
β”‚ β”œβ”€β”€ lab1.c
β”‚ β”œβ”€β”€ lab2.py
β”‚ β”œβ”€β”€ lab3.c
β”‚ β”œβ”€β”€ lab5.c
β”‚ β”œβ”€β”€ lab5.py
β”‚ β”œβ”€β”€ lab6.c
β”‚ └── README.md
β”œβ”€β”€ lib
β”œβ”€β”€ README.md
└── src
β”œβ”€β”€ CMakeLists.txt
β”œβ”€β”€ dev
└── usr

Build and install​

mkdir build

cd build

cmake ..

make -j

sudo make install

sudo ldconfig

xApp SDK through Google Drive​

If you have access to the Google Drive folder with the xApp SDK you can download the file xapp-source.tar.gz.

To unzip the file you can run:

tar -xvf xapp-source.tar.gz

Build and install​

mkdir build

cd build

cmake ..

make -j

sudo make install

sudo ldconfig