YCSB/geode
Sean Busbey 12ce3a8504 [version] update master branch to 0.18.0-SNAPSHOT 2019-09-21 01:24:50 -05:00
..
src/main/java/site/ycsb/db Move all packages from com.yahoo.ycsb to site.ycsb. (#1354) 2019-09-19 13:51:09 -05:00
README.md [geode] Ensure geode client will work with v1.3 by removing references to internal classes (#1069) 2018-03-27 23:28:46 -05:00
pom.xml [version] update master branch to 0.18.0-SNAPSHOT 2019-09-21 01:24:50 -05:00

README.md

Quick Start

This section describes how to run YCSB on Apache Geode.

Get Apache Geode

You can download Geode from https://geode.apache.org/releases/

Start Geode Cluster

Use the Geode shell (gfsh) to start the cluster. You will need to start at-least one locator which is a member discovery service and one or more Geode servers.

Launch gfsh:

$ cd $GEODE_HOME
$ ./bin/gfsh

Start a locator and two servers:

gfsh> start locator --name=locator1
gfsh> configure pdx --read-serialized=true
gfsh> start server --name=server1 --server-port=40404
gfsh> start server --name=server2 --server-port=40405

Create the "usertable" region required by YCSB driver:

gfsh>create region --name=usertable --type=PARTITION

gfsh has tab autocompletion, so you can play around with various options.

Start YCSB workload

From your YCSB directory, you can run the ycsb workload as follows

./bin/ycsb load geode -P workloads/workloada -p geode.locator=host[port]

(default port of locator is 10334).

In the default mode, ycsb geode driver will connect as a client to the geode cluster. To make the ycsb driver a peer member of the distributed system use the property -p geode.topology=p2p -p geode.locator=host[port]

YCSB uses geode 1.2.0, which should be compatible with all later versions of the geode server. To make YCSB run with a different version of the geode client, you can change the geode.version property in pom.xml.

Note: For update workloads, please use the property -p writeallfields=true