hbase在ubuntu上的安装教程

在 Ubuntu 上安装 HBase 的简明教程

一 环境准备

• 操作系统建议：Ubuntu 20.04/22.04 LTS。
• 安装 Java 8（JDK 1.8），HBase 2.x 系列对 Java 8 兼容稳定；如使用 HBase 1.2.x，也需 Java 8。验证命令：java -version。
• 如需使用 HDFS 存储（伪分布式/分布式），先安装并启动 Hadoop 3.x，并确保 SSH 免密登录 localhost 正常。
• 准备工具：wget/curl、tar、vim。
  以上要点与版本建议可参考多篇在 Ubuntu 上安装 HBase 的实操文章与教程说明。

二 安装步骤

• 下载 HBase（以 2.5.4 为例，亦可选择其他稳定版）：
  • 官网镜像目录：https://archive.apache.org/dist/hbase/
  • 示例命令：wget https://archive.apache.org/dist/hbase/2.5.4/hbase-2.5.4-bin.tar.gz
• 解压并安装到 /usr/local：
  • sudo tar -zxf hbase-2.5.4-bin.tar.gz -C /usr/local
  • sudo mv /usr/local/hbase-2.5.4 /usr/local/hbase
  • sudo chown -R $USER:$USER /usr/local/hbase
• 配置环境变量（写入 ~/.bashrc 或 /etc/profile）：
  • export HBASE_HOME=/usr/local/hbase
  • export PATH=$PATH:$HBASE_HOME/bin
  • 使配置生效：source ~/.bashrc
• 验证安装：hbase version（应输出版本信息）。

三 配置与启动

• 单机模式（本地文件系统，适合入门与功能验证）
  • 编辑 $HBASE_HOME/conf/hbase-env.sh：
    • export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64
    • export HBASE_MANAGES_ZK=true（使用内置 ZooKeeper）
  • 编辑 $HBASE_HOME/conf/hbase-site.xml：
    • 设置持久化目录（避免使用默认的 /tmp，防止重启丢数据）：

      <configuration>
        <property>
          <name>hbase.rootdir</name>
          <value>file:///usr/local/hbase/hbase-tmp</value>
        </property>
      </configuration>
      

  • 启动与验证：
    • 启动：$HBASE_HOME/bin/start-hbase.sh
    • Shell：$HBASE_HOME/bin/hbase shell
    • 简单验证：status、create 't1','f1'、put 't1','r1','f1:q','v1'、scan 't1'
    • 停止：$HBASE_HOME/bin/stop-hbase.sh
• 伪分布式模式（基于本地 HDFS，更接近生产）
  • 前提：Hadoop 已启动，NameNode RPC 端口通常为 9000。
  • 编辑 $HBASE_HOME/conf/hbase-env.sh：
    • export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64
    • export HBASE_MANAGES_ZK=true
  • 编辑 $HBASE_HOME/conf/hbase-site.xml：

    <configuration>
      <property>
        <name>hbase.rootdir</name>
        <value>hdfs://localhost:9000/hbase</value>
      </property>
      <property>
        <name>hbase.cluster.distributed</name>
        <value>true</value>
      </property>
      <property>
        <name>hbase.zookeeper.quorum</name>
        <value>localhost</value>
      </property>
    </configuration>
    

  • 启动顺序与验证：
    • 启动 Hadoop → 启动 HBase → hbase shell → status
    • 停止顺序：停止 HBase → 停止 Hadoop
  • 常用进程检查：jps 应能看到 HMaster、HRegionServer（若使用内置 ZK，还能看到 HQuorumPeer）。

四 常见问题与排查

• Java 版本不匹配：HBase 2.5.x 建议使用 Java 8；若误用 Java 11+ 可能导致启动失败或类找不到，需切换至 JDK 8 并重新配置 JAVA_HOME。
• 数据丢失风险：未设置 hbase.rootdir 时默认写入 /tmp，系统重启会丢失数据；务必显式配置到持久目录（本地或 HDFS）。
• 启动失败排查：优先查看 $HBASE_HOME/logs/ 下对应进程的 .log 文件；常见原因包括 HDFS 未启动、端口被占用、JAVA_HOME 错误、主机名解析问题等。
• 进程与端口：确认 HMaster/RegionServer 进程存在；必要时调整 hbase.master.port、hbase.regionserver.port 等端口配置，避免冲突。