Installing cygnus-ngsi from sources



cygnus-common must be installed. This includes Maven, cygnus user creation, log4j path creation, Apache Flume and cygnus-flume-ng script installation.


Installing Cygnus

Cloning fiware-cygnus

Start by cloning the Github repository:

$ git clone
$ cd fiware-cygnus
$ git checkout <branch>

<branch> should be typically a stable release branch, e.g. release/0.13.0, but could also be master (synchronized with the latest release) or develop (contains the latest not stable changes).


Installing cygnus-ngsi

cygnus-ngsi can be built as a fat Java jar file containing all third-party dependencies (recommended):

$ cd cygnus-ngsi
$ APACHE_MAVEN_HOME/bin/mvn clean compile exec:exec assembly:single
$ cp target/cygnus-ngsi-<x.y.z>-jar-with-dependencies.jar APACHE_FLUME_HOME/plugins.d/cygnus/lib

Or as a thin Java jar file:

$ cd cygnus-ngsi
$ APACHE_MAVEN_HOME/bin/mvn exec:exec package
$ cp target/cygnus-<x.y.z>.jar APACHE_FLUME_HOME/plugins.d/cygnus/lib

Finally, please find a script containing all the commands shown in this section. It must be parameterized with the version of the current branch and the Apache Flume base path.


Known issues

It may happen while compiling cygnus-ngsi the Maven JVM has not enough memory. This can be changed as detailed at the Maven official documentation:

$ export MAVEN_OPTS="-Xmx512m -XX:MaxPermSize=128m"


Installing dependencies

These are the packages you will need to install under APACHE_FLUME_HOME/plugins.d/cygnus/libext/ if you did not included them in the cygnus-common jar:

Cygnus dependencies Version Required by / comments
mockito-all 1.9.5 Unit tests
junit 4.11 Unit tests
httpcore 4.3.1 Overwrites the one bundled in Apache Flume
log4j 1.2.17 Logging
slf4j-simple 1.7.21 Logging
cygnus-common latest