Professional Documents
Culture Documents
Documentation
Release 1.0.0
Bodastage Solutions
1 Guide 3
1.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.2 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.3 Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.4 Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.5 Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.6 Rest API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.7 Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.8 Mediation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.9 Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.10 FAQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.11 API Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.12 Road map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2 Appendix 11
2.1 License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
i
ii
Boda Telecom Suite - CE Documentation, Release 1.0.0
Boda Telecom Suite - Community Edition (BTS-CE) is an open source telecommunication network management
platform. The project aims to leverate the best in open source software , big data and machine learning to provide a
feature rich platform for network management. The project was started in 2017 by Bodastage Solutions with a vision
of setting up a platform and building a community around it. Initial focus is on Radio Network Optimization and
automation.
An enterprise edition and hosted version are available at http://www.bodastage.com
Note: There are a number of topics that aren’t written yet but we are continuously updating the documentation. Issues
related to the documentation should be reported at https://github.com/bodastage/bts-ce-docs/issues
Contents 1
Boda Telecom Suite - CE Documentation, Release 1.0.0
2 Contents
CHAPTER 1
Guide
1.1 Introduction
Boda Telecom Suite - Community Edition (BTS-CE) is an open source telecommunication network management
platform. The project aims to leverate the best in open source software , big data and machine learning to provide a
feature rich platform for network management. The project was started in 2017 by Bodastage Solutions with a vision
of setting up a platform and building a community around it. Initial focus is on Radio Network Optimization and
automation.
1.2 Installation
The BTS-CE application is distributed in Docker containers to simplify the installation. Docker is a way to distribute
self-contained applications easily. We provide Docker images for the Community Edition that you can very easily
install and upgrade on your PC, Laptops, or server. The docker hub repositories are located at https://hub.docker.com/
u/bodastage/
Although this is the recommended installation method, you can still download the individual components from the
Bodastage Solutions github page and install them as your see fit.
1.2.1 Requirements
3
Boda Telecom Suite - CE Documentation, Release 1.0.0
1.2.2 Windows
When installing Docker CE on Windows,yYou can either use Hyper-V or Oracle VirtualBox. These are used to create
virtual machines from which your containers will run.
HyperV is an optional feature available on Windows 10 Enterprise, Professional, or Education. If you are using
Windows 10 Home or any other windows release, you will need to upgrade or use Oracle VirtualBox.
To manually enable the Hyper-V role:
1. Right click on the Windows button and select ‘Programs and Features’.
4 Chapter 1. Guide
Boda Telecom Suite - CE Documentation, Release 1.0.0
When the installation has completed you are prompted to restart your computer
1.2. Installation 5
Boda Telecom Suite - CE Documentation, Release 1.0.0
1.3 Resources
6 Chapter 1. Guide
Boda Telecom Suite - CE Documentation, Release 1.0.0
1.4 Architecture
1.5 Modules
The different functionality is organised in modules. Each module performs a specific function. Some modules depend
on others.
Below is a list of the modules currently avaiable:
• Network Browser
• Network Baseline
• Network Audit
Review the roadmap for a full list of what future releases will provide
To be added.
1.7 Database
BTS-CE uses PostgreSQL database. Versions from 9.6 onwards are recommended.
You can get the PostgreSQL database from https://www.postgresql.org.
1.8 Mediation
One of the biggest challenges we have had to address is how to handle the many complex depend data
pipelines/workflows necessary to load data into the database, transform it, and perform other domain specific pro-
1.4. Architecture 7
Boda Telecom Suite - CE Documentation, Release 1.0.0
cessing.
Rather than re-invent the wheel we carefully surveyed the available open source data pipeline and ETL tools. We
narrowed down on Apache’s Airflow project started at Airbnb. What it does is pure magic! Below is a sample of the
Ericsson 3g4g ETL process defined as a DAG(Directed Acyclic Graph) in Airflow. Each dependency is clearly defined
and easy to track.
The next figure below shows the duration of the entire process with the time each sub- task took displayed in a Gantt
chart. Identifying which process is the bottleneck become a trivial task.
8 Chapter 1. Guide
Boda Telecom Suite - CE Documentation, Release 1.0.0
1.9 Integration
1.10 FAQ
• Which vendors are supported? At the moment, Ericsson, Huawei, ZTE, and Nokia. More will be added with
time.
• Which technologies are suppoted? Currently, GSM, UMTS, and LTE are supported.
1.9. Integration 9
Boda Telecom Suite - CE Documentation, Release 1.0.0
10 Chapter 1. Guide
CHAPTER 2
Appendix
2.1 License
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.
"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.
11
Boda Telecom Suite - CE Documentation, Release 1.0.0
12 Chapter 2. Appendix
Boda Telecom Suite - CE Documentation, Release 1.0.0
(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and
(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and
You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.
6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.
2.1. License 13
Boda Telecom Suite - CE Documentation, Release 1.0.0
http://www.apache.org/licenses/LICENSE-2.0
14 Chapter 2. Appendix