diff --git a/rados/README.md b/rados/README.md new file mode 100644 index 00000000..cc085f45 --- /dev/null +++ b/rados/README.md @@ -0,0 +1,64 @@ + + +## Quick Start + +This section describes how to run YCSB on RADOS of Ceph. + +### 1. Start Ceph + +After you start your Ceph cluster, check your cluster’s health first. You can check on the health of your Ceph cluster with the following: + + ceph health + +### 2. Install Java and Maven + +### 3. Set Up YCSB + +Git clone YCSB and compile: + + git clone -b dev-ceph-rados https://github.com/jaemyoun/YCSB.git + cd YCSB + mvn -pl com.yahoo.ycsb:rados-binding -am clean package + +### 4. Configuration Parameters + +- `rados.configfile` + - The Path of Ceph configuration file + - Default is '/etc/ceph/ceph.conf' + +- `rados.id` + - The user ID to access to pools in order to read and write data + - Default is 'admin' + +- `rados.pool` + - The pool name to be used for the benchmark + - Default is 'data' + +Or, you can set configs with the shell command, EG: + + ./bin/ycsb load rados -s -P workloads/workloada -p "rados.configfile=/etc/ceph/ceph.conf" -p "rados.id=admin" -p "rados.pool=data" > outputLoad.txt + +### 5. Load data and run tests + +Load the data: + + ./bin/ycsb load redis -s -P workloads/workloada > outputLoad.txt + +Run the workload test: + + ./bin/ycsb run redis -s -P workloads/workloada > outputRun.txt