Index: src/docbkx/configuration.xml
===================================================================
--- src/docbkx/configuration.xml (revision 1339219)
+++ src/docbkx/configuration.xml (working copy)
@@ -401,36 +401,22 @@
HBase. Do not use this configuration for production nor for
evaluating HBase performance.
- Once you have confirmed your HDFS setup, edit
- conf/hbase-site.xml. This is the file into
+ First, confirm your local HDFS setup. Below is an example conf/hdfs-site.xml. Note
+ that the replication is set to 1 because this is a pseudo-distributed setup. The properties dfs.name.dir
+ and dfs.data.dir are being set explicitly, the latter being where HDFS data will exist on your machine.
+
+ Next, configure HBase for usage. Below is an example conf/hbase-site.xml. Note
+ that the hbase.rootdir property points to the local HDFS instance. This is the file into
which you add local customizations and overrides for
- and . Point HBase at the running Hadoop HDFS
- instance by setting the hbase.rootdir property.
- This property points HBase at the Hadoop filesystem instance to use.
- For example, adding the properties below to your
- hbase-site.xml says that HBase should use the
- /hbase directory in the HDFS whose namenode is
- at port 8020 on your local machine, and that it should run with one
- replica only (recommended for pseudo-distributed mode):
+ and
+
-
-<configuration>
- ...
- <property>
- <name>hbase.rootdir</name>
- <value>hdfs://localhost:8020/hbase</value>
- <description>The directory shared by RegionServers.
- </description>
- </property>
- <property>
- <name>dfs.replication</name>
- <value>1</value>
- <description>The replication count for HLog and HFile storage. Should not be greater than HDFS datanode count.
- </description>
- </property>
- ...
-</configuration>
-
+ Now skip to for how to start and verify your
+ pseudo-distributed install.
+ See Pseudo-distributed
+ mode extras for notes on how to start extra Masters and
+ RegionServers when running pseudo-distributed.
+ Let HBase create the hbase.rootdir
@@ -445,14 +431,90 @@
want to connect from a remote location.
- Now skip to for how to start and verify your
- pseudo-distributed install.
- See Pseudo-distributed
- mode extras for notes on how to start extra Masters and
- RegionServers when running pseudo-distributed.
-
-
+
+
+ Pseudo-distributed Configuration Files
+ The following are exmaple configuration files from a pseudo-distributed setup.
+
+hdfs-site.xml
+
+<configuration>
+ ...
+ <property>
+ <name>dfs.name.dir</name>
+ <value>/Users/local/user.name/hdfs-data-name</value>
+ </property>
+ <property>
+ <name>dfs.data.dir</name>
+ <value>/Users/local/user.name/hdfs-data</value>
+ </property>
+ <property>
+ <name>dfs.replication</name>
+ <value>1</value>
+ </property>
+ ...
+</configuration>
+
+
+hbase-site.xml
+
+<configuration>
+ ...
+ <property>
+ <name>hbase.rootdir</name>
+ <value>hdfs://localhost:8020/hbase</value>
+ </property>
+ <property>
+ <name>hbase.zookeeper.quorum</name>
+ <value>localhost</value>
+ </property>
+ <property>
+ <name>hbase.cluster.distributed</name>
+ <value>true</value>
+ </property>
+ ...
+</configuration>
+
+
+
+
+
+ Pseudo-distributed Extras
+
+
+ Startup
+ To start up the initial HBase cluster...
+ % bin/start-hbase.sh
+
+ To start up an extra backup master(s) on the same server run...
+ % bin/local-master-backup.sh start 1
+ ... the '1' means use ports 60001 & 60011, and this backup master's logfile will be at logs/hbase-${USER}-1-master-${HOSTNAME}.log.
+
+ To startup multiple backup masters run... % bin/local-master-backup.sh start 2 3 You can start up to 9 backup masters (10 total).
+
+ To start up more regionservers...
+ % bin/local-regionservers.sh start 1
+ where '1' means use ports 60201 & 60301 and its logfile will be at logs/hbase-${USER}-1-regionserver-${HOSTNAME}.log.
+
+ To add 4 more regionservers in addition to the one you just started by running... % bin/local-regionservers.sh start 2 3 4 5
+ This supports up to 99 extra regionservers (100 total).
+
+
+
+ Stop
+ Assuming you want to stop master backup # 1, run...
+ % cat /tmp/hbase-${USER}-1-master.pid |xargs kill -9
+ Note that bin/local-master-backup.sh stop 1 will try to stop the cluster along with the master.
+
+ To stop an individual regionserver, run...
+ % bin/local-regionservers.sh stop 1
+
+
+
+
+
+
+
Fully-distributed
Index: src/site/site.xml
===================================================================
--- src/site/site.xml (revision 1339219)
+++ src/site/site.xml (working copy)
@@ -58,7 +58,6 @@
-