Debian系统下HBase配置指南

1. 安装前准备

1.1 更新系统

在开始配置前，先更新Debian系统的软件包列表和已安装的软件包，确保系统环境最新：

sudo apt update && sudo apt upgrade -y

1.2 安装Java环境

HBase依赖Java运行环境，推荐安装OpenJDK 8或11（HBase 2.x及以上版本兼容性更好）：

sudo apt install openjdk-11-jdk -y

安装完成后，验证Java是否安装成功：

java -version

输出应包含Java版本信息（如openjdk version "11.0.xx"）。

2. 下载并解压HBase

2.1 下载HBase

从Apache HBase官方网站下载最新稳定版本（如2.4.x），使用wget命令下载：

wget https://archive.apache.org/dist/hbase/2.4.10/hbase-2.4.10-bin.tar.gz

2.2 解压并移动到指定目录

将下载的压缩包解压到/opt目录（系统软件常用路径），并重命名为hbase：

tar -xzvf hbase-2.4.10-bin.tar.gz -C /opt
sudo mv /opt/hbase-2.4.10 /usr/local/hbase

3. 配置HBase环境变量

3.1 编辑环境变量文件

编辑用户级的~/.bashrc文件（或系统级的/etc/profile），添加HBase的环境变量：

echo 'export HBASE_HOME=/usr/local/hbase' >> ~/.bashrc
echo 'export PATH=$PATH:$HBASE_HOME/bin' >> ~/.bashrc

3.2 使环境变量生效

执行以下命令使配置立即生效：

source ~/.bashrc

4. 配置HBase核心参数

4.1 配置hbase-env.sh

进入HBase的conf目录，复制模板文件并设置JAVA_HOME：

cd /usr/local/hbase/conf
cp hbase-env.sh.template hbase-env.sh
echo 'export JAVA_HOME=/usr/lib/jvm/default-java' >> hbase-env.sh  # 或使用`sudo update-alternatives --config java`查看Java路径

4.2 配置hbase-site.xml

编辑hbase-site.xml文件，添加以下核心配置（根据部署模式调整）：

单机模式（Standalone）

<configuration>
  <property>
    <name>hbase.rootdir</name>
    <value>file:///usr/local/hbase/data</value>  <!-- 本地文件系统路径 -->
  </property>
  <property>
    <name>hbase.cluster.distributed</name>
    <value>false</value>  <!-- 单机模式 -->
  </property>
  <property>
    <name>hbase.zookeeper.property.dataDir</name>
    <value>/usr/local/zookeeper</value>  <!-- Zookeeper数据目录 -->
  </property>
</configuration>

分布式模式（Pseudo-Distributed/Distributed）

<configuration>
  <property>
    <name>hbase.rootdir</name>
    <value>hdfs://namenode:8020/hbase</value>  <!-- HDFS地址（需替换为实际NameNode地址） -->
  </property>
  <property>
    <name>hbase.cluster.distributed</name>
    <value>true</value>  <!-- 分布式模式 -->
  </property>
  <property>
    <name>hbase.zookeeper.quorum</name>
    <value>zookeeper1,zookeeper2,zookeeper3</value>  <!-- Zookeeper集群地址（逗号分隔） -->
  </property>
  <property>
    <name>hbase.zookeeper.property.dataDir</name>
    <value>/var/lib/zookeeper</value>  <!-- Zookeeper数据目录 -->
  </property>
</configuration>

4.3 配置Hadoop（可选，分布式模式必需）

若使用Hadoop的HDFS作为HBase的底层存储，需配置Hadoop环境变量并确保HDFS已启动：

echo 'export HADOOP_HOME=/opt/hadoop' >> ~/.bashrc  # 替换为实际Hadoop路径
echo 'export PATH=$PATH:$HADOOP_HOME/bin:$HADOOP_HOME/sbin' >> ~/.bashrc
source ~/.bashrc

编辑hbase-env.sh，关闭HBase自带的ZooKeeper（若使用独立ZooKeeper集群）：

echo 'export HBASE_MANAGES_ZK=false' >> hbase-env.sh

5. 启动HBase服务

5.1 启动HBase

在HBase的bin目录下，执行以下命令启动HBase集群：

cd /usr/local/hbase/bin
./start-hbase.sh

启动后会显示starting master, logging to logs/hbase-*.out等日志信息。

5.2 验证启动状态

• Web UI：打开浏览器访问http://localhost:16010（默认端口），查看HBase集群状态。
• Shell命令：进入HBase shell，执行status命令：

  ./hbase shell
  hbase(main):001:0> status
  

  输出应显示1 servers（单机模式）或多个RegionServer（分布式模式）。

6. 停止HBase服务

若需停止HBase，执行以下命令：

./stop-hbase.sh

注意事项

1. 依赖服务：分布式模式下，需提前安装并启动Hadoop（HDFS）和ZooKeeper集群，确保HBase能访问这些服务。
2. 端口开放：若通过远程访问，需配置防火墙开放HBase相关端口（如16010、2181、16000-16030等）：

   sudo ufw allow 16000:16030/tcp
   sudo ufw allow 2181/tcp
   

3. 配置调整：根据实际硬件资源和业务需求，调整hbase-site.xml中的参数（如hbase.regionserver.handler.count、hbase.hregion.max.filesize等）。
4. 日志排查：若启动失败，查看logs目录下的日志文件（如hbase-master-*.log、hbase-regionserver-*.log），定位问题原因。