Qakka 技术文档

1. 安装指南

系统要求

在单个区域或数据中心中运行 Qakka 的最低要求如下：

• 运行 Java 8 和 Apache Tomcat 7 或 8 的一个或多个计算机
• 运行 Cassandra 2.1.x 版本的 Apache Cassandra 集群

安装步骤

1. 安装 Java 8：确保每个计算机都安装了 Java 8。

2. 安装 Tomcat 7 或 8：在每台计算机上安装 Apache Tomcat 7 或 8。

3. 部署 Qakka WAR 文件：将 Qakka 的 WAR 文件放置在 Tomcat 的 webapps 目录下。

4. 配置 qakka.properties：在 Tomcat 的 lib 目录下创建一个 qakka.properties 文件，用于配置 Qakka、Cassandra 连接和 Usergrid 集群。

   参考配置文件：qakka.properties

5. 安装 Cassandra 2.1.x：在每台计算机上安装 Cassandra 2.1.x。

6. 验证集群状态：确保 Cassandra 集群正常工作。

2. 项目的使用说明

Qakka 是 Apache Usergrid 中内置的分布式和多区域队列系统的独立版本。它是一个 Java Web 应用程序，结合了 Usergrid Actor System 和 Queue 模块以及基于 Jersey JAX-RS 的 REST API。

功能

• 支持多个命名队列
• 分布式和多区域
  • 队列消息可以发送到多个区域
  • 队列读取始终从本地区域进行
• 未确认的队列消息超时
• 无模式队列消息负载，支持 JSON 或 BLOB 格式的任何内容类型
• 支持 REST 和 Java API

3. 项目 API 使用文档

Qakka 提供了 REST API 用于与队列服务交互。目前，我们还没有关于 Qakka REST API 使用的示例，但提供了 Swagger 生成的文档：

• Qakka REST API 文档

4. 项目安装方式

Qakka 尚未公开发布，如果您想使用它，需要自行编译。以下是编译 Qakka 的步骤：

• 确保安装了 Java 8 JDK 和 Maven 3。
• 如果要运行 JUnit 测试，还需要安装 Cassandra 2.1.x。

1. 编译 Usergrid "Stack"：

   • 克隆 Apache Usergrid 仓库，并在 /stack 目录下运行 mvn -DskipTests=true install。
   • 这将把 Usergrid jar 文件放入本地 Maven 仓库，以便 Qakka 可以找到它们。

2. 编译 Qakka：

   • 克隆 Apache Usergrid Qakka 仓库，并在 Qakka 的目录下运行 mvn -DskipTests=true install。

如果想要运行 Qakka 的 JUnit 测试，需要确保 Cassandra 2.1.x 在本地计算机上运行（默认设置，例如端口 9160），然后可以使用 mvn test 命令运行测试。Qakka 的测试只针对 REST API；Usergrid 队列模块中有更多的 Qakka 测试。