|author||Dave Johnson <email@example.com>||Fri Dec 02 11:09:20 2016 -0500|
|committer||Dave Johnson <firstname.lastname@example.org>||Fri Dec 02 11:09:20 2016 -0500|
Adding how to build docs.
Standalone version of Usergrid's Qakka queue service.
Qakka is a standalone version of the distributed and multi-region queue system that it built-into Apache Usergrid. It is a Java web application that combines the Usergrid Actor System and Queue modules with a Jersey JAX-RS based REST API.
Minimal requires for Qakka in one region or data center are:
You can learn more about Qakka internals by reading this Google Slides presentation.
Qakka was developed as for this JIRA Issue: USERGRID-1318.
Qakka is unreleased software and if you want to use it, you will have to built it. Here are the steps to build Qakka:
You will need Java 8 JDK and Maven 3 to build Qakka. You will also need Cassandra 2.1.x if you want to run the JUnit tests.
Build the Usergrid “Stack”:
mvn -DskipTests=true installin the
mvn -DskipTests=true installin Qakka's directory.
If you want to run the Qakka JUnit tests, you will need to have Cassandra 2.1.x running on your computer with the default setup (e.g. on port 9160). You can run the tests with
mvn tests. The tests in Qakka only hit the REST API; there are more Qakka tests in the Usergrid Queue module.
We don‘t have installation documentation or scripts yet, but here’s an overview of what you'll have to do to setup Qakka:
In each region, setup your Tomcat computers
In each region, setup your Cassandra computers
There is an example qakka.properties file that contains some information about how to configure Qakka, its Cassandra connections and its Usergrid Clustering.