- Installing cygnus-ngsi
- Installing dependencies
cygnus-common must be installed. This includes Maven,
cygnus user creation,
log4j path creation, Apache Flume and
cygnus-flume-ng script installation.
Start by cloning the Github repository:
$ git clone https://github.com/telefonicaid/fiware-cygnus.git $ 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).
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
compile.sh 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.
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"
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|
|httpcore||4.3.1||Overwrites the one bundled in Apache Flume|