Installing cygnus-twitter from sources
Content:
Prerequisites
cygnus-common
must be installed. This includes Maven, cygnus
user creation, Apache Flume and cygnus-flume-ng
script installation.
Installing Cygnus
Cloning fiware-cygnus
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/1.1.0
, but could also be master
(synchronized with the latest release) or develop
(contains the latest not stable changes).
Installing cygnus-twitter
cygnus-twitter
can be built as a fat Java jar file containing all third-party dependencies (recommended):
$ cd cygnus-twitter
$ APACHE_MAVEN_HOME/bin/mvn clean compile exec:exec assembly:single
$ cp target/cygnus-twitter-<x.y.z>-jar-with-dependencies.jar APACHE_FLUME_HOME/plugins.d/cygnus/lib
Or as a thin Java jar file:
$ cd cygnus-twitter
$ APACHE_MAVEN_HOME/bin/mvn exec:exec package
$ cp target/cygnus-<x.y.z>.jar APACHE_FLUME_HOME/plugins.d/cygnus/lib
Known issues
It may happen while compiling cygnus-twitter
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 |
log4j | 1.2.17 | Logging |
slf4j-simple | 1.7.21 | Logging |
cygnus-common | latest |