diff --git a/src/docbkx/book.xml b/src/docbkx/book.xml
index bd6f5455feb..961a279333a 100644
--- a/src/docbkx/book.xml
+++ b/src/docbkx/book.xml
@@ -89,7 +89,7 @@
Here is a quick guide to starting up a standalone HBase
- instance, inserting rows into a table via the
+ instance, creating a table and inserting rows into a table via the
HBase Shell, and then cleaning up and shutting
down your running instance.
@@ -101,7 +101,7 @@
Download Mirrors. Click on it. This will take you to a
mirror of HBase Releases. Click on
the folder named stable and then download the
- file that ends in .tar.gz;
+ file that ends in .tar.gz to your local filesystem;
e.g. hbase-.tar.gz.Decompress and untar your download and then change into the
@@ -112,16 +112,20 @@ $ cd hbase-
$ ./bin/start-hbase.sh
starting master, logging to logs/hbase-user-master-example.org.out
- You now have a running HBase instance. HBase logs can be
- found in the logs subdirectory. Check them
+ You now have a running standalone HBase instance. In standalone mode, HBase runs
+ all daemons in the the one JVM; i.e. the master, regionserver, and zookeeper daemons.
+ Also by default, HBase in standalone mode writes data to /tmp/hbase-${USERID}.
+ HBase logs can be found in the logs subdirectory. Check them
out especially if HBase had trouble starting.Is java installed?
- The above presumes a 1.6 version of Oracle java is installed on your
+ The above presumes a 1.6 version of Oracle
+ java is installed on your
machine and available on your path; i.e. when you type
java, you see output that describes the options
- the java program takes. If this is not the case, HBase will not start.
+ the java program takes (HBase like Hadoop requires java 6). If this is
+ not the case, HBase will not start.
Install java, edit conf/hbase-env.sh, uncommenting the
JAVA_HOME line pointing it to your java install. Then,
retry the steps above.
@@ -150,10 +154,14 @@ hbase(main):001:0> Create a table named test with a single
- column family named cf. and then insert some
+ column family named cf.. Verify its creation by
+ listing all tables and then insert some
values.hbase(main):003:0> create 'test', 'cf'
0 row(s) in 1.2200 seconds
+hbase(main):003:0> list 'table'
+test
+1 row(s) in 0.0550 seconds
hbase(main):004:0> put 'test', 'row1', 'cf:a', 'value1'
0 row(s) in 0.0560 seconds
hbase(main):005:0> put 'test', 'row2', 'cf:b', 'value2'
@@ -210,6 +218,7 @@ hbase(main):013:0> drop 'test'
stopping hbase...............
+ To learn how to set up a HBase in distributed mode, see the next section.