[db voltdb] Add VoltDB client

distribution/pom.xml

@@ -286,6 +286,12 @@ LICENSE file.
       <version>${project.version}</version>
     </dependency>
 -->
+    <dependency>
+       <groupId>com.yahoo.ycsb</groupId>
+       <artifactId>voltdb-binding</artifactId>
+       <version>${project.version}</version>
+     </dependency>
+
   </dependencies>
   <build>
     <plugins>

pom.xml

@@ -110,6 +110,7 @@ LICENSE file.
     <thrift.version>0.8.0</thrift.version>
     <voldemort.version>0.81</voldemort.version>
     <tablestore.version>4.8.0</tablestore.version>
+    <voltdb.version>9.0</voltdb.version>
   </properties>
 
   <modules>
@@ -168,6 +169,7 @@ LICENSE file.
     <module>tarantool</module>
     <module>tablestore</module>
     <!--<module>voldemort</module>-->
+    <module>voltdb</module>
   </modules>
 
   <build>

voltdb/README.md

@@ -0,0 +1,68 @@
+# YCSB for VoltDB
+
+![VoltDB Logo](https://www.voltdb.com/wp-content/uploads/2016/10/VoltDB-logo-320x132.jpg?ycsb=true "VoltDB")
+
+## README
+
+This README describes how to run YCSB on VoltDB. 
+
+Here at VoltDB we use 4 machines for testing - 1 client and a 3 node cluster.
+
+### 1. Install Java on all the machines involved.
+
+VoltDB uses Java. Either [Oracle Java](https://www.oracle.com/technetwork/java/javase/downloads/index.html) or [OpenJDK](https://openjdk.java.net/) will work.
+
+
+### 3. Install and configure VoltDB
+
+If you don't already have a copy of VoltDB you should [download](https://www.voltdb.com/try-voltdb/)  and install it. 
+Make sure you know the hostnames/ip addresses of all the nodes in the cluster and that [port 21212](https://docs.voltdb.com/AdminGuide/HostConfigPortOpts.php) is open for your client.
+
+A representative VoltDB cluster would have 3 nodes and a '[K factor](https://docs.voltdb.com/UsingVoltDB/KSafeEnable.php)' of 1. This configuration allows work to continue if a server dies.
+
+Note: If you contact us we can give you access to AWS Cloudformation scripts and a matching AMI to create a cluster for you.
+
+### 4. Install YCSB
+
+Download the [latest YCSB](https://github.com/brianfrankcooper/YCSB/releases/latest) file. Follow the instructions.
+
+### 5. Configure VoltDB parameters
+
+Create a file called (for example) voltdb.properties:
+
+    recordcount=10000000
+    operationcount=10000000
+    voltdb.servers=localhost
+    threadcount=40
+
+Other possible entries would be:
+
+- `voltdb.user`
+   	- Username. Only needed if username/passwords enabled.
+- `voltdb.password`
+   	- Password. Only needed if username/passwords enabled.
+- `voltdb.ratelimit`
+   	- Maximum number of transactions allowed per second per 50 threads - e.g. 'voltdb.ratelimit=70000'. Note that as you increase the workload you eventually get to a point where throwing more and more transactions at a given configuration is counterproductive. For the three node configuration we mentioned above 70000 would be a good starting point for this value.
+- `voltdb.scanall` 
+	- Uses a single query to return data for 'Scan' operations ('workload e') instead of a separate query per partition. The later is much more scalable but generates more network traffic.
+
+### 6. Run YCSB
+
+See: [Running a Workload](https://github.com/brianfrankcooper/YCSB/wiki/Running-a-Workload)
+
+Make sure you keep an eye on the voltdb GUI. If you installed VoltDB on the same computer you are running YCSB on it will be at: 
+
+    http://localhost:8080/
+
+First load the data:
+
+    bin/ycsb.sh load voltdb -P workloads/workloada -P voltdb.properties 
+
+Then run the different workloads - 'a' through 'e':
+
+     bin/ycsb.sh run voltdb -P workloads/workloada -P voltdb.properties 
+     bin/ycsb.sh run voltdb -P workloads/workloadb -P voltdb.properties 
+     bin/ycsb.sh run voltdb -P workloads/workloadc -P voltdb.properties 
+     bin/ycsb.sh run voltdb -P workloads/workloadd -P voltdb.properties 
+     bin/ycsb.sh run voltdb -P workloads/workloade -P voltdb.properties 
+

voltdb/pom.xml

@@ -0,0 +1,59 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- 
+Copyright (c) 2012 - 2016 YCSB contributors. All rights reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License"); you
+may not use this file except in compliance with the License. You
+may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+implied. See the License for the specific language governing
+permissions and limitations under the License. See accompanying
+LICENSE file.
+-->
+
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>com.yahoo.ycsb</groupId>
+    <artifactId>binding-parent</artifactId>
+    <version>0.17.0-SNAPSHOT</version>
+    <relativePath>../binding-parent</relativePath>
+  </parent>
+
+  <artifactId>voltdb-binding</artifactId>
+  <name>VoltDB Binding</name>
+  <packaging>jar</packaging>
+  <dependencies>
+   <dependency>
+      <groupId>com.yahoo.ycsb</groupId>
+      <artifactId>core</artifactId>
+      <version>${project.version}</version>
+      <scope>provided</scope>
+    </dependency>
+     <dependency>
+      <groupId>junit</groupId>
+      <artifactId>junit</artifactId>
+      <version>4.12</version>
+      <scope>test</scope>
+    </dependency>
+<!-- https://mvnrepository.com/artifact/org.voltdb/voltdbclient -->
+<dependency>
+    <groupId>org.voltdb</groupId>
+    <artifactId>voltdbclient</artifactId>
+    <version>9.0</version>
+</dependency>
+<!-- https://mvnrepository.com/artifact/org.voltdb/voltdb -->
+<dependency>
+    <groupId>org.voltdb</groupId>
+    <artifactId>voltdb</artifactId>
+    <version>9.0</version>
+</dependency>
+ </dependencies>
+</project>
+