Building from sources

Orion Context Broker reference distribution is CentOS 8.x. This doesn't mean that the broker cannot be built in other distributions (actually, it can). This section also includes indications on how to build in other distributions, just in the case it may help people that don't use CentOS. However, note that the only "officially supported" procedure is the one for CentOS 8.x; the others are provided "as is" and can get obsolete from time to time.

CentOS 8.x (officially supported)

The Orion Context Broker uses the following libraries as build dependencies:

boost: 1.66
libmicrohttpd: 0.9.70 (from source)
libcurl: 7.61.1
openssl: 1.1.1g
libuuid: 2.32.1
Mongo C driver: 1.17.4 (from source)
rapidjson: 1.1.0 (from source)
gtest (only for make unit_test building target): 1.5 (from sources)
gmock (only for make unit_test building target): 1.5 (from sources)

The basic procedure is as follows (assuming you don't run commands as root, we use sudo for those commands that require root privilege):

Install the needed building tools (compiler, etc.).
```
  sudo yum install make cmake gcc-c++
```

Install the required libraries (except what needs to be taken from source, described in following steps).

  sudo yum install boost-devel libcurl-devel gnutls-devel libgcrypt-devel openssl-devel libuuid-devel cyrus-sasl-devel

Install the Mongo Driver from source.

  wget https://github.com/mongodb/mongo-c-driver/releases/download/1.17.4/mongo-c-driver-1.17.4.tar.gz
  tar xfvz mongo-c-driver-1.17.4.tar.gz
  cd mongo-c-driver-1.17.4
  mkdir cmake-build
  cd cmake-build
  cmake -DENABLE_AUTOMATIC_INIT_AND_CLEANUP=OFF ..
  make
  sudo make install

Install rapidjson from sources:

  wget https://github.com/miloyip/rapidjson/archive/v1.1.0.tar.gz
  tar xfvz v1.1.0.tar.gz
  sudo mv rapidjson-1.1.0/include/rapidjson/ /usr/local/include

Install libmicrohttpd from sources (the ./configure command below shows the recommended build configuration to get minimum library footprint, but if you are an advanced user, you can configure as you prefer)

  wget http://ftp.gnu.org/gnu/libmicrohttpd/libmicrohttpd-0.9.70.tar.gz
  tar xvf libmicrohttpd-0.9.70.tar.gz
  cd libmicrohttpd-0.9.70
  ./configure --disable-messages --disable-postprocessor --disable-dauth
  make
  sudo make install  # installation puts .h files in /usr/local/include and library in /usr/local/lib
  sudo ldconfig      # just in case... it doesn't hurt :)

Get the code (alternatively you can download it using a zipped version or a different URL pattern, e.g git clone git@github.com:telefonicaid/fiware-orion.git):
```
  sudo yum install git
  git clone https://github.com/telefonicaid/fiware-orion
```
Build the source:
```
  cd fiware-orion
  make
```
(Optional but highly recommended) run unit test and functional tests. More on this on its specific section below.
Install the binary. You can use INSTALL_DIR to set the installation prefix path (default is /usr), thus the broker is installed in $INSTALL_DIR/bin directory.
```
  sudo make install INSTALL_DIR=/usr
```
Check that everything is ok, invoking the broker version message:
```
  contextBroker --version
```

Testing, coverage and RPM

The Orion Context Broker comes with a suite of unit, valgrind and end-to-end tests that you can also run, following the following procedure (optional but highly recommended):

Install Google Test/Mock from sources (there are RPM packages for this, but they do not work with the current CMakeLists.txt configuration). Previously the URL was http://googlemock.googlecode.com/files/gmock-1.5.0.tar.bz2 but Google removed that package in late August 2016 and it is no longer working.

  sudo yum install python2
  wget https://nexus.lab.fiware.org/repository/raw/public/storage/gmock-1.5.0.tar.bz2
  tar xfvj gmock-1.5.0.tar.bz2
  cd gmock-1.5.0
  ./configure
  sed -i 's/env python/env python2/' gtest/scripts/fuse_gtest_files.py  # little hack to make installation to work on CentOS 8
  make
  sudo make install  # installation puts .h files in /usr/local/include and library in /usr/local/lib
  sudo ldconfig      # just in case... it doesn't hurt :)

In the case of the aarch64 architecture, install libxslt using yum, and run ./configure with --build=arm-linux option.

Install MongoDB (tests rely on mongod running in localhost). Check the official MongoDB documentation for details. Recommended version is 4.4 (it may work with previous versions, but we don't recommend it).
Run unit test
```
  make unit_test
```

Install additional required tools for functional and valgrind tests:

  sudo yum install curl nc valgrind bc
  sudo pip2 install virtualenv

In the case of the aarch64 architecture, additionally install python2-devel, rpm-build and libffi-devel using yum. It is needed when building pyOpenSSL.

Prepare the environment for test harness. Basically, you have to install the accumulator-server.py script and in a path under your control, ~/bin is the recommended one. Alternatively, you can install them in a system directory such as /usr/bin but it could collide with an RPM installation, thus it is not recommended. In addition, you have to set several environment variables used by the harness script (see scripts/testEnv.sh file) and create a virtualenv environment with the required Python packages.
```
  mkdir ~/bin
  export PATH=~/bin:$PATH
  make install_scripts INSTALL_DIR=~
  . scripts/testEnv.sh
  virtualenv /opt/ft_env --python=/usr/bin/python2
  . /opt/ft_env/bin/activate
  pip install Flask==1.0.2 pyOpenSSL==19.0.0
```
Run test harness in this environment (it takes some time, please be patient).
```
  make functional_test INSTALL_DIR=~
```
Once passed all the functional tests, you can run the valgrind tests (this will take longer than the functional tests, arm yourself with a lot of patience):
```
  make valgrind INSTALL_DIR=~
```

You can generate coverage reports for the Orion Context Broker using the following procedure (optional):

Install the lcov tool

  # Download .rpm file from http://downloads.sourceforge.net/ltp/lcov-1.14-1.noarch.rpm
  sudo yum install lcov-1.14-1.noarch.rpm

Do first a successful pass for unit_test and functional_test, to check that everything is ok (see above)
Run coverage
```
  make coverage INSTALL_DIR=~
```

You can generate the RPM for the source code (optional):

Install the required tools
```
  sudo yum install rpm-build
```
Generate the RPM
```
  make rpm
```
The generated RPMs are placed in directory ~/rpmbuild/RPMS/x86_64.

Ubuntu 20.04 LTS

This instruction is how to build the Orion Context Broker for the x86_64 or the aarch64 architecture on Ubuntu 20.04 LTS. And it includes the instruction to build MongoDB 4.4 that the Orion depends on. The Orion Context Broker uses the following libraries as build dependencies:

boost: 1.71.0
libmicrohttpd: 0.9.70 (from source)
libcurl: 7.68.0
openssl: 1.1.1f
libuuid: 2.34-0.1
Mongo C driver: 1.17.4 (from source)
rapidjson: 1.1.0 (from source)
gtest (only for make unit_test building target): 1.5 (from sources)
gmock (only for make unit_test building target): 1.5 (from sources)

The basic procedure is as follows (assuming you don't run commands as root, we use sudo for those commands that require root privilege):

Install the needed building tools (compiler, etc.).
```
  sudo apt install build-essential cmake
```

Install the required libraries (except what needs to be taken from source, described in following steps).

  sudo apt install libboost-dev libboost-regex-dev libboost-thread-dev libboost-filesystem-dev \
                   libcurl4-gnutls-dev gnutls-dev libgcrypt-dev libssl-dev uuid-dev libsasl2-dev

Install the Mongo Driver from source.

  wget https://github.com/mongodb/mongo-c-driver/releases/download/1.17.4/mongo-c-driver-1.17.4.tar.gz 
  tar xfvz mongo-c-driver-1.17.4.tar.gz 
  cd mongo-c-driver-1.17.4 
  mkdir cmake-build 
  cd cmake-build 
  cmake -DENABLE_AUTOMATIC_INIT_AND_CLEANUP=OFF .. 
  make 
  make install

Install rapidjson from sources:

  wget https://github.com/miloyip/rapidjson/archive/v1.1.0.tar.gz
  tar xfvz v1.1.0.tar.gz
  sudo mv rapidjson-1.1.0/include/rapidjson/ /usr/local/include

Install libmicrohttpd from sources (the ./configure command below shows the recommended build configuration to get minimum library footprint, but if you are an advanced user, you can configure as you prefer)

  wget http://ftp.gnu.org/gnu/libmicrohttpd/libmicrohttpd-0.9.70.tar.gz
  tar xvf libmicrohttpd-0.9.70.tar.gz
  cd libmicrohttpd-0.9.70
  ./configure --disable-messages --disable-postprocessor --disable-dauth
  make
  sudo make install  # installation puts .h files in /usr/local/include and library in /usr/local/lib
  sudo ldconfig      # just in case... it doesn't hurt :)

Get the code (alternatively you can download it using a zipped version or a different URL pattern, e.g git clone git@github.com:telefonicaid/fiware-orion.git):
```
  sudo apt install git
  git clone https://github.com/telefonicaid/fiware-orion
```
Build the source:
```
  cd fiware-orion
  make
```
(Optional but highly recommended) run unit test and functional tests. More on this on its specific section below.
Install the binary. You can use INSTALL_DIR to set the installation prefix path (default is /usr), thus the broker is installed in $INSTALL_DIR/bin directory.
```
  sudo make install INSTALL_DIR=/usr
```
Check that everything is ok, invoking the broker version message:
```
  contextBroker --version
```

Testing and coverage

The Orion Context Broker comes with a suite of functional, valgrind and end-to-end tests that you can also run, following the following procedure (optional):

Install Google Test/Mock from sources (there are RPM packages for this, but they do not work with the current CMakeLists.txt configuration). Previously the URL was http://googlemock.googlecode.com/files/gmock-1.5.0.tar.bz2 but Google removed that package in late August 2016 and it is no longer working.

  apt install python-is-python2 xsltproc
  wget https://nexus.lab.fiware.org/repository/raw/public/storage/gmock-1.5.0.tar.bz2
  tar xfvj gmock-1.5.0.tar.bz2
  cd gmock-1.5.0
  ./configure
  make
  sudo make install  # installation puts .h files in /usr/local/include and library in /usr/local/lib
  sudo ldconfig      # just in case... it doesn't hurt :)

In the case of the aarch64 architecture, run ./configure with --build=arm-linux option.

Install MongoDB (tests rely on mongod running in localhost). Check the official MongoDB documentation for details. Recommended version is 4.4 (it may work with previous versions, but we don't recommend it).
Run unit test:
```
  make unit_test
```

Install additional required tools for functional and valgrind tests:

  curl https://bootstrap.pypa.io/pip/2.7/get-pip.py --output get-pip.py 
  sudo python get-pip.py 
  sudo apt install netcat valgrind bc 
  sudo pip install --upgrade pip 
  pip install virtualenv

In the case of the aarch64 architecture, additionally install python2-dev and libffi-dev using apt. It is needed when building pyOpenSSL.

Prepare the environment for test harness. Basically, you have to install the accumulator-server.py script and in a path under your control, ~/bin is the recommended one. Alternatively, you can install them in a system directory such as /usr/bin but it could collide with an RPM installation, thus it is not recommended. In addition, you have to set several environment variables used by the harness script (see scripts/testEnv.sh file) and create a virtualenv environment to use Flask version 1.0.2 instead of default Flask in Ubuntu. Run test harness in this environment.
```
  mkdir ~/bin
  export PATH=~/bin:$PATH
  make install_scripts INSTALL_DIR=~
  . scripts/testEnv.sh
  virtualenv /opt/ft_env
  . /opt/ft_env/bin/activate
  pip install Flask==1.0.2 pyOpenSSL==19.0.0
```

Run test harness (it takes some time, please be patient). Before starting test by make command, apply the following patch to avoid test failing.

  sed -i -e "s/Peer certificate cannot be authenticated[^\"]*/SSL peer certificate or SSH remote key was not OK/" /opt/fiware-orion/test/functionalTest/cases/0706_direct_https_notifications/direct_https_notifications_no_accept_selfsigned.test
  make functional_test INSTALL_DIR=~

Once passed all the functional tests, you can run the valgrind tests (this will take longer than the functional tests, arm yourself with a lot of patience):
```
  make valgrind
```

You can generate coverage reports for the Orion Context Broker using the following procedure (optional):

Install the lcov tool
```
  sudo apt install lcov
```
Do first a successful pass for unit_test and functional_test, to check that everything is ok (see above)
Run coverage
```
  make coverage INSTALL_DIR=~
```

Setup for running Orion as system service after running tests. Run the curl localhost:1026/version command to check that the setup has been successful:

  sudo mkdir /etc/sysconfig
  sudo cp /opt/fiware-orion/etc/config/contextBroker /etc/sysconfig/
  sudo touch /var/log/contextBroker/contextBroker.log
  sudo chown orion /var/log/contextBroker/contextBroker.log
  sudo cp /opt/fiware-orion/rpm/SOURCES/etc/logrotate.d/logrotate-contextBroker-daily /etc/logrotate.d/
  sudo cp /opt/fiware-orion/rpm/SOURCES/etc/sysconfig/logrotate-contextBroker-size /etc/sysconfig/
  sudo cp /opt/fiware-orion/rpm/SOURCES/etc/cron.d/cron-logrotate-contextBroker-size /etc/cron.d/
  sudo systemctl daemon-reload
  sudo systemctl start contextBroker.service

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

build_source.md

build_source.md

Building from sources

CentOS 8.x (officially supported)

Testing, coverage and RPM

Ubuntu 20.04 LTS

Testing and coverage

Files

build_source.md

Latest commit

History

build_source.md

File metadata and controls

Building from sources

CentOS 8.x (officially supported)

Testing, coverage and RPM

Ubuntu 20.04 LTS

Testing and coverage