1. 快速單擊安裝
在單機安裝Hbase的方法。會引導你通過shell創建一個表，插入一行，然后刪除它，最后停止Hbase。只要10分鍾就可以完成以下的操作。
1.1下載解壓最新版本
選擇一個 Apache 下載鏡像：http://www.apache.org/dyn/closer.cgi/hbase/，下載 HBase Releases. 點擊 stable目錄，然后下載后綴為 .tar.gz 的文件; 例如 hbase-0.90.4.tar.gz.
后面需要安裝集群，整合到hadoop，所以注意選擇與hadoop對應的版本：
選擇 Hadoop 版本對HBase部署很關鍵。下表顯示不同HBase支持的Hadoop版本信息。基於HBase版本，應該選擇合適的Hadoop版本。我們沒有綁定 Hadoop 發行版選擇。可以從Apache使用 Hadoop 發行版，或了解一下Hadoop發行商產品： http://wiki.apache.org/hadoop/Distributions%20and%20Commercial%20Support
Table 2.1. Hadoop version support matrix
| HBase-0.92.x | HBase-0.94.x | HBase-0.96 | |
|---|---|---|---|
| Hadoop-0.20.205 | S | X | X |
| Hadoop-0.22.x | S | X | X |
| Hadoop-1.0.x | S | S | S |
| Hadoop-1.1.x | NT | S | S |
| Hadoop-0.23.x | X | S | NT |
| Hadoop-2.x | X | S | S |
| S = supported and tested,支持 |
| X = not supported,不支持 |
| NT = not tested enough.可以運行但測試不充分 |
由於 HBase 依賴 Hadoop，它配套發布了一個Hadoop jar 文件在它的 lib 下。該套裝jar僅用於獨立模式。在分布式模式下，Hadoop版本必須和HBase下的版本一致。用你運行的分布式Hadoop版本jar文件替換HBase lib目錄下的Hadoop jar文件，以避免版本不匹配問題。確認替換了集群中所有HBase下的jar文件。Hadoop版本不匹配問題有不同表現，但看起來都像掛掉了。
安裝：
$ cd hbase-0.90.4
現在你已經可以啟動Hbase了。但是你可能需要先編輯 conf/hbase-site.xml 去配置hbase.rootdir，來選擇Hbase將數據寫到哪個目錄 .
單機配置，只需要如下配置hbase-site.xml：
- <?xml version="1.0"?>
- <?xml-stylesheet type="text/xsl" href="configuration.xsl"?>
- <configuration>
- <property>
- <name>hbase.rootdir</name>
- <value>file:///DIRECTORY/hbase</value>
- </property>
- </configuration>
將 DIRECTORY 替換成你期望寫文件的目錄. 默認 hbase.rootdir 是指向 /tmp/hbase-${user.name} ，也就說你會在重啟后丟失數據(重啟的時候操作系統會清理/tmp目錄)
1.2. 啟動 HBase
現在啟動Hbase:
$ ./bin/start-hbase.sh
starting Master, logging to logs/hbase-user-master-example.org.out
現在你運行的是單機模式的Hbaes。所以的服務都運行在一個JVM上，包括Hbase和Zookeeper。Hbase的日志放在logs目錄,當你啟動出問題的時候，可以檢查這個日志。
1.3. Hbase Shell 練習
用shell連接你的Hbase
$ ./bin/hbase shell
HBase Shell; enter 'help<RETURN>' for list of supported commands.
Type "exit<RETURN>" to leave the HBase Shell
Version: 0.90.0, r1001068, Fri Sep 24 13:55:42 PDT 2010
hbase(main):001:0>
輸入 help 然后 <RETURN> 可以看到一列shell命令。這里的幫助很詳細，要注意的是表名，行和列需要加引號。
創建一個名為 test 的表，這個表只有一個column family 為 cf。可以列出所有的表來檢查創建情況，然后插入些值。
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'
0 row(s) in 0.0370 seconds
hbase(main):006:0> put 'test', 'row3', 'cf:c', 'value3'
0 row(s) in 0.0450 seconds
以上我們分別插入了3行。第一個行key為row1, 列為 cf:a， 值是 value1。Hbase中的列是由 column family前綴和列的名字組成的，以冒號間隔。例如這一行的列名就是a.
檢查插入情況.
Scan這個表，操作如下
hbase(main):007:0> scan 'test'
ROW COLUMN+CELL
row1 column=cf:a, timestamp=1288380727188, value=value1
row2 column=cf:b, timestamp=1288380738440, value=value2
row3 column=cf:c, timestamp=1288380747365, value=value3
3 row(s) in 0.0590 seconds
Get一行，操作如下
hbase(main):008:0> get 'test', 'row1'
COLUMN CELL
cf:a timestamp=1288380727188, value=value1
1 row(s) in 0.0400 seconds
disable 再 drop 這張表，可以清除你剛剛的操作
hbase(main):012:0> disable 'test'
0 row(s) in 1.0930 seconds
hbase(main):013:0> drop 'test'
0 row(s) in 0.0770 seconds
關閉shell
hbase(main):014:0> exit
1.4. 停止 HBase
運行停止腳本來停止HBase.
$ ./bin/stop-hbase.sh
stopping hbase...............
1） Java：（hadoop已經安裝了）
2） Hadoop 0.20.x / Hadoop-2.x 已經正確安裝，並且可以啟動 HDFS 系統, 可參考的Hadoop安裝文檔：Hadoop集群配置（最全面總結）http://blog.csdn.net/hguisu/article/details/7237395
3） ssh 必須安裝ssh ， sshd 也必須運行，這樣Hadoop的腳本才可以遠程操控其他的Hadoop和Hbase進程。ssh之間必須都打通，不用密碼都可以登錄，詳細方法可以 Google一下 ("ssh passwordless login").
4） NTP：集群的時鍾要保證基本的一致。稍有不一致是可以容忍的，但是很大的不一致會 造成奇怪的行為。 運行 NTP 或者其他什么東西來同步你的時間.
如果你查詢的時候或者是遇到奇怪的故障，可以檢查一下系統時間是否正確!
設置集群各個節點時鍾：date -s “2012-02-13 14:00:00”
Base是數據庫，會在同一時間使用很多的文件句柄。大多數linux系統使用的默認值1024是不能滿足的，會導致FAQ: Why do I see "java.io.IOException...(Too manyopen files)" in my logs?異常。還可能會發生這樣的異常
2010-04-06 03:04:37,542 INFO org.apache.hadoop.hdfs.DFSClient: ExceptionincreateBlockOutputStream java.io.EOFException
2010-04-06 03:04:37,542 INFO org.apache.hadoop.hdfs.DFSClient:Abandoning block blk_-6935524980745310745_1391901
所以你需要修改你的最大文件句柄限制。可以設置到10k. 你還需要修改 hbase 用戶的 nproc，如果過低會造成 OutOfMemoryError異常。 [2] [3].
需要澄清的，這兩個設置是針對操作系統的，不是Hbase本身的。有一個常見的錯誤是Hbase運行的用戶，和設置最大值的用戶不是一個用戶。在Hbase啟動的時候，第一行日志會現在ulimit信息，所以你最好檢查一下。
可以先查看當前用戶 ulimit：
ulimit -n
設置ulimit:
如果你使用的是Ubuntu,你可以這樣設置:
在文件 /etc/security/limits.conf 添加一行，如:
hadoop - nofile 32768
可以把 hadoop 替換成你運行Hbase和Hadoop的用戶。如果你用兩個用戶，你就需要配兩個。還有配nproc hard 和 softlimits. 如:
hadoop soft/hard nproc 32000
在 /etc/pam.d/common-session 加上這一行:
session required pam_limits.so
否則在 /etc/security/limits.conf上的配置不會生效.
還有注銷再登錄，這些配置才能生效!
7 ）修改Hadoop HDFS Datanode同時處理文件的上限：dfs.datanode.max.xcievers
一個 Hadoop HDFS Datanode 有一個同時處理文件的上限. 這個參數叫 xcievers (Hadoop的作者把這個單詞拼錯了). 在你加載之前，先確認下你有沒有配置這個文件conf/hdfs-site.xml里面的xceivers參數，至少要有4096:
<property>
<name>dfs.datanode.max.xcievers</name>
<value>4096</value>
</property>
對於HDFS修改配置要記得重啟.
如果沒有這一項配置，你可能會遇到奇怪的失敗。你會在Datanode的日志中看到xcievers exceeded，但是運行起來會報 missing blocks錯誤。例如: 02/12/1220:10:31 INFO hdfs.DFSClient: Could not obtain blockblk_XXXXXXXXXXXXXXXXXXXXXX_YYYYYYYY from any node: java.io.IOException: No livenodes contain current block. Will get new block locations from namenode andretry...
8）繼承hadoop安裝的說明：
每個機子/etc/hosts
10.64.56.74 node2 （master）
10.64.56.76 node1 （slave）
10.64.56.77 node3 （slave）
9) 繼續使用hadoop用戶安裝
Chown –R hadoop /usr/local/hbase
3.1配置conf/hbase-env.sh
# exportJAVA_HOME=/usr/java/jdk1.6.0/
exportJAVA_HOME=/usr/lib/jvm/java-6-sun-1.6.0.26
# Tell HBase whether it should manage it'sown instance of Zookeeper or not.
export HBASE_MANAGES_ZK=true
不管是什么模式，你都需要編輯 conf/hbase-env.sh來告知Hbase java的安裝路徑.在這個文件里你還可以設置Hbase的運行環境，諸如 heapsize和其他 JVM有關的選項, 還有Log文件地址，等等. 設置 JAVA_HOME指向 java安裝的路徑.
一個分布式運行的Hbase依賴一個zookeeper集群。所有的節點和客戶端都必須能夠訪問zookeeper。默認的情況下Hbase會管理一個zookeep集群。這個集群會隨着Hbase的啟動而啟動。當然，你也可以自己管理一個zookeeper集群，但需要配置Hbase。你需要修改conf/hbase-env.sh里面的HBASE_MANAGES_ZK 來切換。這個值默認是true的，作用是讓Hbase啟動的時候同時也啟動zookeeper.
讓Hbase使用一個現有的不被Hbase托管的Zookeep集群，需要設置 conf/hbase-env.sh文件中的HBASE_MANAGES_ZK 屬性為 false
# Tell HBase whether it should manage it's own instanceof Zookeeper or not.
exportHBASE_MANAGES_ZK=false
3.2 配置conf/hbase-site.xml
- <configuration>
- <property>
- <name>hbase.rootdir</name>
- <value>hdfs://node1:49002/hbase</value>
- <description>The directory shared byRegionServers.
- </description>
- </property>
- <property>
- <name>hbase.cluster.distributed</name>
- <value>true</value>
- <description>The mode the clusterwill be in. Possible values are
- false: standalone and pseudo-distributedsetups with managed Zookeeper
- true: fully-distributed with unmanagedZookeeper Quorum (see hbase-env.sh)
- </description>
- </property>
- <property>
- <name>hbase.zookeeper.property.clientPort</name>
- <value>2222</value>
- <description>Property fromZooKeeper's config zoo.cfg.
- The port at which the clients willconnect.
- </description>
- </property>
- <property>
- <name>hbase.zookeeper.quorum</name>
- <value>node1,node2,node3</value>
- <description>Comma separated listof servers in the ZooKeeper Quorum.
- For example,"host1.mydomain.com,host2.mydomain.com,host3.mydomain.com".
- By default this is set to localhost forlocal and pseudo-distributed modes
- of operation. For a fully-distributedsetup, this should be set to a full
- list of ZooKeeper quorum servers. IfHBASE_MANAGES_ZK is set in hbase-env.sh
- this is the list of servers which we willstart/stop ZooKeeper on.
- </description>
- </property>
- <property>
- <name>hbase.zookeeper.property.dataDir</name>
- <value>/home/hadoop/zookeeper</value>
- <description>Property fromZooKeeper's config zoo.cfg.
- The directory where the snapshot isstored.
- </description>
- </property>
- </configuration>
要想運行完全分布式模式，加一個屬性 hbase.cluster.distributed 設置為 true 然后把 hbase.rootdir 設置為HDFS的NameNode的位置。 例如，你的namenode運行在node1，端口是49002 你期望的目錄是 /hbase,使用如下的配置：hdfs://node1:49002/hbase
hbase.rootdir：這個目錄是region server的共享目錄，用來持久化Hbase。URL需要是'完全正確'的，還要包含文件系統的scheme。例如，要表示hdfs中的'/hbase'目錄，namenode 運行在node1的49002端口。則需要設置為hdfs://node1:49002/hbase。默認情況下Hbase是寫到/tmp的。不改這個配置，數據會在重啟的時候丟失。默認: file:///tmp/hbase-${user.name}/hbase
hbase.cluster.distributed ：Hbase的運行模式。false是單機模式，true是分布式模式。若為false,Hbase和Zookeeper會運行在同一個JVM里面。
默認: false
在hbase-site.xml配置zookeeper：
當Hbase管理zookeeper的時候，你可以通過修改zoo.cfg來配置zookeeper，
一個更加簡單的方法是在 conf/hbase-site.xml里面修改zookeeper的配置。Zookeeer的配置是作為property寫在 hbase-site.xml里面的。
對於zookeepr的配置，你至少要在 hbase-site.xml中列出zookeepr的ensemble servers，具體的字段是 hbase.zookeeper.quorum. 該這個字段的默認值是 localhost，這個值對於分布式應用顯然是不可以的. (遠程連接無法使用)。
hbase.zookeeper.property.clientPort：ZooKeeper的zoo.conf中的配置。 客戶端連接的端口。
hbase.zookeeper.quorum：Zookeeper集群的地址列表，用逗號分割。例如："host1.mydomain.com,host2.mydomain.com,host3.mydomain.com".默認是localhost,是給偽分布式用的。要修改才能在完全分布式的情況下使用。如果在hbase-env.sh設置了HBASE_MANAGES_ZK，這些ZooKeeper節點就會和Hbase一起啟動。
默認: localhost
運行一個zookeeper也是可以的，但是在生產環境中，你最好部署3，5，7個節點。部署的越多，可靠性就越高，當然只能部署奇數個，偶數個是不可以的。你需要給每個zookeeper 1G左右的內存，如果可能的話，最好有獨立的磁盤。 (獨立磁盤可以確保zookeeper是高性能的。).如果你的集群負載很重，不要把Zookeeper和RegionServer運行在同一台機器上面。就像DataNodes 和 TaskTrackers一樣
hbase.zookeeper.property.dataDir：ZooKeeper的zoo.conf中的配置。 快照的存儲位置
把ZooKeeper保存數據的目錄地址改掉。默認值是 /tmp ，這里在重啟的時候會被操作系統刪掉，可以把它修改到 /home/hadoop/zookeeper (這個路徑hadoop用戶擁有操作權限)
對於獨立的Zookeeper，要指明Zookeeper的host和端口。可以在 hbase-site.xml中設置, 也可以在Hbase的CLASSPATH下面加一個zoo.cfg配置文件。 HBase 會優先加載 zoo.cfg 里面的配置，把hbase-site.xml里面的覆蓋掉.
參見 http://www.yankay.com/wp-content/hbase/book.html#hbase_default_configurations可以查找hbase.zookeeper.property 前綴，找到關於zookeeper的配置。
3.3 配置conf/regionservers
Node1
Node2
完全分布式模式的還需要修改conf/regionservers. 在這里列出了你希望運行的全部 HRegionServer，一行寫一個host (就像Hadoop里面的 slaves 一樣). 列在這里的server會隨着集群的啟動而啟動，集群的停止而停止.
3.4 替換hadoop的jar包
hadoop-annotations-2.1.0-beta.jar
hadoop-auth-2.1.0-beta.jar
hadoop-client-2.1.0-beta.jar
hadoop-common-2.1.0-beta.jar
hadoop-hdfs-2.1.0-beta.jar
hadoop-hdfs-2.1.0-beta-tests.jar
hadoop-mapreduce-client-app-2.1.0-beta.jar
hadoop-mapreduce-client-common-2.1.0-beta.jar
hadoop-mapreduce-client-core-2.1.0-beta.jar
hadoop-mapreduce-client-jobclient-2.1.0-beta.jar
hadoop-mapreduce-client-jobclient-2.1.0-beta-tests.jar
hadoop-mapreduce-client-shuffle-2.1.0-beta.jar
hadoop-yarn-api-2.1.0-beta.jar
hadoop-yarn-client-2.1.0-beta.jar
hadoop-yarn-common-2.1.0-beta.jar
hadoop-yarn-server-common-2.1.0-beta.jar
hadoop-yarn-server-nodemanager-2.1.0-beta.jar
4. 運行和確認安裝
4.1當Hbase托管ZooKeeper的時候
當Hbase托管ZooKeeper的時候Zookeeper集群的啟動是Hbase啟動腳本的一部分
首先確認你的HDFS是運行着的。你可以運行HADOOP_HOME中的 bin/start-hdfs.sh 來啟動HDFS.你可以通過put命令來測試放一個文件，然后有get命令來讀這個文件。通常情況下Hbase是不會運行mapreduce的。所以比不需要檢查這些。
用如下命令啟動Hbase:
bin/start-hbase.sh
這個腳本在HBASE_HOME目錄里面。
你現在已經啟動Hbase了。Hbase把log記在 logs 子目錄里面. 當Hbase啟動出問題的時候，可以看看Log.
Hbase也有一個界面，上面會列出重要的屬性。默認是在Master的60010端口上H (HBase RegionServers 會默認綁定 60020端口，在端口60030上有一個展示信息的界面 ).如果Master運行在 node1，端口是默認的話，你可以用瀏覽器在 http://node:60010看到主界面. .
一旦Hbase啟動，可以看到如何建表，插入數據，scan你的表，還有disable這個表，最后把它刪掉。
可以在Hbase Shell停止Hbase
$./bin/stop-hbase.sh
stoppinghbase...............
停止操作需要一些時間，你的集群越大，停的時間可能會越長。如果你正在運行一個分布式的操作，要確認在Hbase徹底停止之前，Hadoop不能停.
4.2獨立的zookeeper啟動，
除了啟動habse，
執行：bin/start-hbase.sh啟動habse
你需要自己去運行zookeeper：
${HBASE_HOME}/bin/hbase-daemons.sh {start,stop} zookeeper
你可以用這條命令啟動ZooKeeper而不啟動Hbase. HBASE_MANAGES_ZK 的值是 false， 如果你想在Hbase重啟的時候不重啟ZooKeeper,你可以這樣。
5. 測試
可以使用jps查看進程：在master上：
在node2，node3（slave節點）上
通過瀏覽器查看60010端口：
1 ）
用./start-hbase.sh啟動HBase后，執行hbase shell
# bin/hbase shell
HBase Shell; enter 'help<RETURN>' for list of supported commands.
Version: 0.20.6, rUnknown, Thu Oct 28 19:02:04 CST 2010
接着創建表時候出現如下情況：hbase(main):001:0> create 'test',''c
NativeException: org.apache.hadoop.hbase.MasterNotRunningException: null
jps下，發現主節點上HMaster沒有啟動，查理HBase log（logs/hbase-hadoop-master-ubuntu.log）里有下面異常：
FATAL org.apache.hadoop.hbase.master.HMaster: Unhandled exception. Starting shutdown.
java.io.IOException: Call to node1/10.64.56.76:49002 failed on local exception: java.io.EOFException
從hadoop_home/下面cp一個hadoop/hadoop-core-0.20.203.0.jar到hbase_home/lib下。
因為Hbase建立在Hadoop之上，所以他用到了hadoop.jar,這個Jar在 lib 里面。這個jar是hbase自己打了branch-0.20-append 補丁的hadoop.jar. Hadoop使用的hadoop.jar和Hbase使用的 必須 一致。所以你需要將 Hbaselib 目錄下的hadoop.jar替換成Hadoop里面的那個，防止版本沖突。比方說CDH的版本沒有HDFS-724而branch-0.20-append里面有，這個HDFS-724補丁修改了RPC協議。如果不替換，就會有版本沖突，繼而造成嚴重的出錯，Hadoop會看起來掛了。
再用./start-hbase.sh啟動HBase后，jps下，發現主節點上HMaster還是沒有啟動，在HBase log里有下面異常：
FATAL org.apache.hadoop.hbase.master.HMaster: Unhandled exception. Starting shutdown.
java.lang.NoClassDefFoundError: org/apache/commons/configuration/Configuration
解決：
在NoClassDefFoundError,缺少 org/apache/commons/configuration/Configuration
果斷給他加一個commons-configuration包，
從hadoop_home/lib下面cp一個hadoop/lib/commons-configuration-1.6.jar到hbase_home/lib下。
（集群上所有機子的hbase配置都需要一樣）
創建表報錯：
ERROR: java.io.IOException: Table Namespace Manager not ready yet, try again later
at org.apache.hadoop.hbase.master.HMaster.getNamespaceDescriptor(HMaster.java:3101)
at org.apache.hadoop.hbase.master.HMaster.createTable(HMaster.java:1738)
at org.apache.hadoop.hbase.master.HMaster.createTable(HMaster.java:1777)
at org.apache.hadoop.hbase.protobuf.generated.MasterProtos$MasterService$2.callBlockingMethod(MasterProtos.java:38221)
at org.apache.hadoop.hbase.ipc.RpcServer.call(RpcServer.java:2146)
at org.apache.hadoop.hbase.ipc.RpcServer$Handler.run(RpcServer.java:1851)
解決：
1） 查看集群的所有機器上，
HRegionServer和HQuorumPeer進程是否都啟動？
2）查看集群的所有機器的logs是不是有錯誤消息；
tail -f hbase-hadoop-regionserver-XXX..log
2 注意事項：
1）、先啟動hadoop后，再開啟hbase2）、去掉hadoop的安全模式：hadoop dfsadmin -safemode leave
3）、把/etc/hosts里的ubuntu的IP改為服務器當前的IP
4) 、確認hbase的hbase-site.xml中
<name>hbase.rootdir</name>
<value>hdfs://node：49002/hbase</value>
與hadoop的core-site.xml中
<name>fs.default.name</name>
<value>hdfs://node：49002/hbase</value>
紅字部分保持一致
<value>hdfs://localhost:8020/hbase</value>
否則報錯：java.lang.RuntimeException: HMaster Aborted
6)、重新執行./start-hbase.sh之前，先kill掉當前的hbase和zookeeper進程
7）hosts注意順序：
192.168.1.214 master
192.168.1.205 node1
192.168.1.207 node2
192.168.1.209 node3
192.168.1.205 T205.joy.cc
PS：遇到問題時，先查看logs，很有幫助。
HBase 官方文檔，全面介紹hbase安裝配置：
http://www.yankay.com/wp-content/hbase/book.html#hbase_default_configurations