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 @@ - Index: src/site/xdoc/pseudo-distributed.xml =================================================================== --- src/site/xdoc/pseudo-distributed.xml (revision 1339219) +++ src/site/xdoc/pseudo-distributed.xml (working copy) @@ -28,51 +28,12 @@ -

This document augments what is described in the HBase 'Getting Started' in the - Distributed Operation: Pseudo- and Fully-distributed modes section +

This page has been retired. The contents have been moved to the + Distributed Operation: Pseudo- and Fully-distributed modes section in the Reference Guide. - In particular it describes scripts that allow you start extra masters and regionservers when running in pseudo-distributed mode.

-
  1. Copy the pseudo-distributed suggested configuration file (feel free to take a peek and understand what it's doing) - % cp conf/hbase-site.xml{.pseudo-distributed.template,} -
  2. -
  3. (Optional) Start up Pseudo-distributed HDFS. -
    1. If you do, go to conf/hbase-site.xml. Uncomment the 'hbase.rootdir' property. -
    2. -
    3. Additionally, if you want to test HBase with high data durability enabled, also uncomment the 'dfs.support.append' property. -
    4. -
    -
  4. -
  5. Start up the initial HBase cluster - % bin/start-hbase.sh -
    1. To start up an extra backup master(s) on the same server run - % bin/local-master-backup.sh start 1 - Here 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). -
    2. -
    3. 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 - Supports up to 99 extra regionservers (100 total). -
    4. -
    -
  6. -
  7. To stop the cluster -
      -
    1. 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 -
    2. -
    3. To stop an individual regionserver, run - % bin/local-regionservers.sh stop 1 - -
    4. -
    -
  8. -
- +