Apache Accumulo 测试套件技术文档

本文档旨在帮助用户了解和安装Apache Accumulo测试套件，并详细介绍其使用方法、API使用文档以及安装方式。

1. 安装指南

为了运行Apache Accumulo测试套件，您的计算机需要安装Java 8和Maven，并且需要有一个 Accumulo 实例用于测试。

1. 首先，克隆此仓库：

   git clone [e-mail]:apache/accumulo-testing.git
   cd accumulo-testing
   

2. 所有测试套件的配置文件位于conf/目录中。只需要编辑accumulo-testing.properties配置文件，其他配置文件是可选的。在accumulo-testing.properties中，审查以test.common.*为前缀的属性，因为这些属性会被所有测试使用。

   cd conf/
   vim accumulo-testing.properties
   

2. 项目使用说明

测试套件中包含以下脚本，位于bin/目录中：

• cingest - 运行连续写入测试
• rwalk - 运行随机漫步测试
• performance - 运行性能测试
• agitator - 运行激励器
• gcs - 运行垃圾收集仿真
• monitor - 运行可用性监控探测器

运行这些脚本时无需参数，以查看使用方法。

在Docker中运行测试

虽然可以在单台机器上运行测试脚本，但如果在多台机器上运行，压力会更大。使用Docker是最简单的方式，但只有以下测试可以在Docker中运行：

• cingest - 除了verify和moru（这两个会启动MapReduce任务）之外的所有应用程序都可以运行。
• rwalk - 所有模块都可以运行。
• monitor - 所有模块都可以运行。

1. 为了创建accumulo-testing Docker镜像，确保克隆中存在以下文件：

   • conf/accumulo-client.properties - 从您的Accumulo安装中配置此文件
   • conf/accumulo-testing.properties - 为测试配置此文件
   • target/accumulo-testing-2.1.0-SNAPSHOT-shaded.jar - 可以使用./bin/build创建

   使用以下命令创建镜像。HADOOP_HOME应该是集群上Hadoop的安装路径，HADOOP_USER_NAME应该与在集群上运行Hadoop的用户匹配。

   docker build --build-arg HADOOP_HOME=$HADOOP_HOME --build-arg HADOOP_USER_NAME=`whoami` -t accumulo-testing .
   

2. accumulo-testing镜像可以运行单个命令：

   docker run --network="host" accumulo-testing cingest createtable
   

3. 也可以运行多个容器（如果启用了Docker Swarm）：

   # 如果没有注册表，以下命令可用于将镜像传输到所有节点。
   for HOST in node1 node2 node3; do
     docker save accumulo-testing | ssh -C $HOST docker load &
   done
   
   docker service create --network="host" --replicas 2 --name ci accumulo-testing cingest ingest
   

3. 项目API使用文档

具体API使用文档请参考项目官方文档。

4. 项目安装方式

请参考上述“安装指南”部分进行项目安装。