Prerequisites
xApp SDK Source Code
For this training, you will need BubbleRAN's xApp SDK, which is available in our Github repository. For running these labs, 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 started
- 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
- Install MySQL client for xApp storage (deprecated):
sudo apt install libmysqlclient-dev mysql-server
- Install python packages
pip3 install tabulate
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.
xApp SDK through Github
To obtain the BubbleRAN xApp SDK, 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
There are four options available for the next command, depending on the type of database you select.
- No DB (default):
cmake .. - VictoriaMetrics (Recommended):
cmake -DXAPP_DB=VICTORIAMETRICS_XAPP .. - MySQL (Deprecated):
cmake -DXAPP_DB=MYSQL_XAPP ..
After which, complete the build with the next commands:
make -j
sudo make install
sudo ldconfig