From 4dbdd4726c41cf64b40cbd098ad2cb4a933ecb73 Mon Sep 17 00:00:00 2001 From: Connor McCoy <connormccoy@google.com> Date: Wed, 16 Sep 2015 09:24:12 -0700 Subject: [PATCH] [hbase10] README fix. --- hbase10/README.md | 61 ++++------------------------------------------- 1 file changed, 5 insertions(+), 56 deletions(-) diff --git a/hbase10/README.md b/hbase10/README.md index d1b82550..1da5bc43 100644 --- a/hbase10/README.md +++ b/hbase10/README.md @@ -15,60 +15,9 @@ permissions and limitations under the License. See accompanying LICENSE file. --> -# HBase (1.x) Driver for YCSB -This driver is a binding for the YCSB facilities to operate against a HBase 1.x Server cluster. -To run against an HBase 0.9x cluster, use the `hbase` binding. +# HBase (1.0.x) Driver for YCSB +This driver is a binding for the YCSB facilities to operate against a HBase 1.0.x Server cluster. +To run against an HBase 0.94.x cluster, use the `hbase094` binding. +To run against an HBase 0.98.x cluster, use the `hbase098` binding. -## Quickstart - -### 1. Start a HBase Server -You need to start a single node or a cluster to point the client at. Please see [Apache HBase Reference Guide](http://hbase.apache.org/book.html) for more details and instructions. - -### 2. Set up YCSB -You need to clone the repository and compile everything. - -``` -git clone git://github.com/brianfrankcooper/YCSB.git -cd YCSB -mvn clean package -``` - -### 3. Create a HBase table for testing - -For best results, use the pre-splitting strategy recommended in [HBASE-4163](https://issues.apache.org/jira/browse/HBASE-4163): - -``` -hbase(main):001:0> n_splits = 200 # HBase recommends (10 * number of regionservers) -hbase(main):002:0> create 'usertable', 'family', {SPLITS => (1..n_splits).map {|i| "user#{1000+i*(9999-1000)/n_splits}"}} -``` - -*Failing to do so will cause all writes to initially target a single region server*. - -### 4. Run the Workload -Before you can actually run the workload, you need to "load" the data first. - -You should specify a HBase config directory(or any other directory containing your hbase-site.xml) and a table name and a column family(-cp is used to set java classpath and -p is used to set various properties). - -``` -bin/ycsb load hbase10 -P workloads/workloada -cp /HBASE-HOME-DIR/conf -p table=usertable -p columnfamily=family -``` - -Then, you can run the workload: - -``` -bin/ycsb run hbase10 -P workloads/workloada -cp /HBASE-HOME-DIR/conf -p table=usertable -p columnfamily=family -``` - -Please see the general instructions in the `doc` folder if you are not sure how it all works. You can apply additional properties (as seen in the next section) like this: - -``` -bin/ycsb run hbase10 -P workloads/workloada -cp /HBASE-HOME-DIR/conf -p table=usertable -p columnfamily=family -p clientbuffering=true -``` - -## Configuration Options -Following options can be configurable using `-p`. - -* `columnfamily`: The HBase column family to target. -* `clientbuffering` : If true, buffer mutations on the client. The default is false. -* `writebuffersize` : Buffer size to be used when `clientbuffering` is activated. The default is 12MB. -* `debug` : If true, debugging logs are activated. The default is false. +See `hbase098/README.md` for configuration details. -- GitLab