Skip to content

Commit

Permalink
Corrected the repo a,d reformated for markdown
Browse files Browse the repository at this point in the history
  • Loading branch information
helipilot50 committed May 15, 2014
1 parent b699a64 commit addbdb9
Showing 1 changed file with 20 additions and 23 deletions.
43 changes: 20 additions & 23 deletions README → README.md
Original file line number Diff line number Diff line change
@@ -1,26 +1,24 @@
Yahoo! Cloud System Benchmark (YCSB)
====================================
#Yahoo! Cloud System Benchmark (YCSB)

This version of the YCSB tool is modified by Thumbtack Technology to add
support for Aerospike and Couchbase databases, to improve MongoDB driver
and to add some automation to run YCSB on multiple clients.

Links
-----
##Links
http://wiki.github.com/brianfrankcooper/YCSB/
https://github.com/couchbaselabs/YCSB
http://research.yahoo.com/Web_Information_Management/YCSB
ycsb-users@yahoogroups.com
http://docs.fabfile.org/en/1.3.2/

Getting Started
---------------
##Step by step

1. Download the latest release of YCSB:

git clone https://github.com/thumbtack-technology/ycsb.git
```bash
git clone https://github.com/aerospike/ycsb
cd ycsb

```
2. Set up a database and client hosts to benchmark.
There is a README file under each binding directory.

Expand All @@ -33,43 +31,42 @@ Getting Started
Edit files: conf/hosts.py, conf/databases.py, conf/workloads.py

5. Build and deploy YCSB to client hosts

```bash
fab ycsb_deploy

```
6. Load data to databases

```bash
fab ycsb_load:db=<dbname>

<dbname> is aerospike, couchbase, couchbase2, cassandra,
```
`<dbname>` is aerospike, couchbase, couchbase2, cassandra,
mongodb or any other you configured
Edit conf/workloads.py to confiture workloads root directory

7. Run YCSB workload

```bash
fab ycsb_run:db=<dbname>,workload=A

```
8. Check the YCSB status

```bash
fab ycsb_status:db=<dbname>

```
9. Download YCSB results and logs

```bash
fab ycsb_get:db=<dbname>,do=True

```
You'll get some .out and .err files in the current directory downloaded
from all your clients.

10. Aggregate the YCSB results

```bash
./bin/merge.py

```
This script gets the most important parameters from YCSB .out files,
such as throughput and latency, aggregates the results from multiple clients
and prints the result as tab-separated values which can be easy pasted
into any spreadsheet.

Notes
-----
##Notes

This tool was tested using following software versions
* Ubuntu Server (12.04)
Expand Down

0 comments on commit addbdb9

Please sign in to comment.