Google Git
Sign in
apache / usergrid-qakka / 44b07d58daecd54cf4b1a9167b0edeccfaa8bb0b
commit44b07d58daecd54cf4b1a9167b0edeccfaa8bb0b[log] [tgz]
authorDave Johnson <snoopdave@apache.org>Fri Dec 02 10:53:11 2016 -0500
committerDave Johnson <snoopdave@apache.org>Fri Dec 02 10:53:11 2016 -0500
tree31ad08b653c4c04946fb5ce6782ed3fbe14d6139
parent3ad20f3df86c2697017b84619e1b3feed6602366 [diff]
Some basic README docs
2 files changed
tree: 31ad08b653c4c04946fb5ce6782ed3fbe14d6139
  1. docs/
  2. src/
  3. templates/
  4. .gitignore
  5. LICENSE
  6. pom.xml
  7. README.md
README.md

Qakka

Standalone version of Usergrid's Qakka queue service.

Introducting Qakka

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.

Qakka Features

  • Multiple named Queues
  • Distributed and Multi-region
    • Queue messages can be sent to multiple regions
    • Queue reads always from local region
  • Inflight Queue messages time-out if not “acked”
  • Schemaless Queue message payloads, JSON or BLOB with any content-type
  • REST & Java APIs

Qakka System Requirements

Minimal requires for Qakka in one region or data center are:

  • One or more computers running Java 8 and Tomcat 7 or 8
  • A Cassandra cluster running Cassandra 2.1.x

Qakka Internals

You can learn more about Qakka internals by reading this Google Slides presentation.

Qakka was developed as for this JIRA Issue: USERGRID-1318.

Qakka Installation

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

    • Install Java 8
    • Install Tomcat 7 or 8
    • Place the WAR file in the Tomcat's webapps directory
    • Place your qakka.properties file in your Tomcat lib directory
    • If you more than one Tomcat, you probably want to add a Load Balancer, e.g. AWS ELB

  • In each region, setup your Cassandra computers

    • Install Java 8
    • Install Cassandra 2.1.x
    • Verify that your cluster is working

There is an example qakka.properties file that contains some information about how to configure Qakka, its Cassandra connections and its Usergrid Clustering.