Ubuntu如何升级HBase版本

前提准备

1. 确认当前环境：记录当前HBase版本（hbase version）、Hadoop版本（hadoop version）、Java版本（java -version），确保升级后三者兼容。例如，HBase 2.4.x通常需要Hadoop 2.7.x/3.x和Java 8/11。
2. 备份数据：HBase的数据目录（如HDFS上的/hbase、本地/usr/local/hbase/data）和配置文件（hbase-site.xml、hbase-env.sh、regionservers）需完整备份，避免升级丢失。
3. 检查兼容性：查阅HBase官方文档的“Compatibility Matrix”，确认新版本与现有Hadoop、Java版本匹配。例如，HBase 3.0+需要Hadoop 3.2+和Java 11+。

步骤1：卸载旧版HBase

1. 停止HBase服务：运行$HBASE_HOME/bin/stop-hbase.sh，确保HMaster、HRegionServer等进程完全停止。
2. 删除旧文件：
   • 删除HBase安装目录（如sudo rm -rf /usr/local/hbase）；
   • 删除配置目录（如sudo rm -rf /etc/hbase、/var/lib/hbase）；
   • 删除用户配置（如rm -rf ~/.hbase）。
3. 清理环境变量：编辑~/.bashrc或/etc/profile，删除HBASE_HOME、PATH中HBase相关行，执行source ~/.bashrc使变更生效。

步骤2：下载并安装新版本HBase

1. 下载新版本：从Apache官网下载稳定版tar包（如wget https://archive.apache.org/dist/hbase/2.4.18/hbase-2.4.18-bin.tar.gz），建议选择.tar.gz格式避免解压问题。
2. 解压并移动：

   tar -zxvf hbase-2.4.18-bin.tar.gz -C /usr/local/
   sudo mv /usr/local/hbase-2.4.18 /usr/local/hbase  # 统一目录名便于管理
   

3. 配置环境变量：编辑~/.bashrc，添加：

   export HBASE_HOME=/usr/local/hbase
   export PATH=$PATH:$HBASE_HOME/bin
   

   执行source ~/.bashrc使环境变量生效。

步骤3：配置新版本HBase

1. 修改hbase-env.sh：
   • 设置Java路径：export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64（根据实际Java安装路径调整）；
   • 关闭HBase自带ZooKeeper（若使用独立ZooKeeper）：export HBASE_MANAGES_ZK=false。
2. 配置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.property.dataDir</name><value>/tmp/zookeeper</value></property>
     </configuration>
     

   • 集群模式：需配置hbase.zookeeper.quorum（ZooKeeper节点列表）、hbase.rootdir（HDFS地址）等。
3. 配置regionservers：列出所有RegionServer节点（伪分布写localhost，集群写所有节点主机名）。
4. 同步配置到集群：将/usr/local/hbase目录复制到所有RegionServer节点（scp -r /usr/local/hbase hadoop@slave1:/usr/local/），并同步/etc/profile环境变量。

步骤4：启动并验证新版本

1. 启动Hadoop集群（若使用HDFS）：start-dfs.sh、start-yarn.sh，确保HDFS正常运行。
2. 启动HBase：start-hbase.sh，使用jps命令检查进程：应存在HMaster（主节点）、HRegionServer（RegionServer节点）。
3. 验证功能：
   • 进入HBase Shell：hbase shell；
   • 执行简单命令：list（查看表列表）、create 'test', 'cf'（创建表），确认无报错。
4. 检查日志：若启动失败，查看/usr/local/hbase/logs下的hbase-*-master-*.log、hbase-*-regionserver-*.log，定位问题（如版本冲突、配置错误）。

常见问题解决

• 版本冲突：若出现NoSuchMethodError或ClassNotFoundException，可能是Hadoop与HBase依赖冲突。解决方法：删除HBase lib目录下与Hadoop重复的jar包（如slf4j-log4j12），或重新编译HBase适配Hadoop版本。
• 权限问题：确保HBase安装目录及数据目录权限正确（sudo chown -R $USER:$USER /usr/local/hbase），避免进程无法访问文件。
• ZooKeeper问题：若使用内置ZooKeeper，确保hbase.zookeeper.property.dataDir目录存在且有写入权限；若使用独立ZooKeeper，需提前启动并验证连接。