Debian上如何升级HBase版本

Debian上升级HBase的可操作步骤

一 升级前准备

• 明确升级路径与兼容性：确认目标版本与当前 Hadoop、ZooKeeper、Java 的兼容性，优先在测试环境演练。HBase 2.4.x 通常要求 Java 8 或更高版本。
• 备份关键数据与配置：
  • 备份 HBase 在 HDFS 上的数据目录（由 hbase.rootdir 指定）。
  • 备份本地配置与日志：$HBASE_HOME/conf/、$HBASE_HOME/logs/。
• 规划停机窗口：升级期间需停止写入，建议选择业务低峰期执行。
• 准备新版本介质：从 Apache 归档下载目标版本二进制包（示例：https://archive.apache.org/dist/hbase/2.4.10/hbase-2.4.10-bin.tar.gz）。
• 环境检查：确保各节点 网络互通、主机名可解析、时间同步（如 ntp/chrony）。

二 标准升级步骤

1. 停止旧版本
   • 在所有节点执行：$HBASE_HOME/bin/stop-hbase.sh。
2. 备份
   • 备份 HDFS 数据：hdfs dfs -get hdfs://<namenode>:8020/hbase /backup/hbase-hdfs-$(date +%F)。
   • 备份本地配置与日志：tar czf hbase-conf-$(date +%F).tar.gz $HBASE_HOME/conf $HBASE_HOME/logs。
3. 部署新版本
   • 下载并解压：tar -xzvf hbase-<newver>-bin.tar.gz -C /opt。
   • 使用符号链接便于回滚：ln -sfn /opt/hbase-<newver> /opt/hbase。
4. 同步配置
   • 将旧版 $HBASE_HOME/conf/ 下必要配置拷入新版（建议逐项比对，避免覆盖新增项）：
     • hbase-site.xml、hbase-env.sh、regionservers、backup-masters。
   • 在 hbase-env.sh 中设置 JAVA_HOME，并根据你的部署选择是否由 HBase 管理 ZK：export HBASE_MANAGES_ZK=false（使用外部 ZK）。
5. 启动与验证
   • 启动：$HBASE_HOME/bin/start-hbase.sh。
   • 验证：
     • Web UI：访问 http://:16010。
     • Shell：./hbase shell 执行 status、list 等命令。
6. 回滚预案
   • 若异常，切换符号链接回旧版本并重启：ln -sfn /opt/hbase-<oldver> /opt/hbase && start-hbase.sh。

三 常见注意事项

• 配置与目录：确认 hbase.rootdir 仍指向正确的 HDFS 路径；如使用外部 ZooKeeper，确保 hbase.zookeeper.quorum 与 hbase.zookeeper.property.dataDir 正确；必要时保留旧版的本地目录（如 WAL、临时目录）以避免启动时清理导致的数据风险。
• 兼容性：跨小版本升级需关注 HBase 与 Hadoop、ZooKeeper 的版本兼容矩阵；升级前在测试环境验证客户端兼容性。
• 端口与防火墙：确保 16010（Master UI）、2181（ZooKeeper）等端口在防火墙放行。
• 升级顺序：先停 HBase，再升级程序与配置，最后启动；如需滚动升级，请先在测试环境验证，生产环境建议一次性升级并短暂停写。

四 快速参考命令清单

• 停止与备份
  • stop-hbase.sh
  • hdfs dfs -get hdfs://<namenode>:8020/hbase /backup/hbase-$(date +%F)
  • tar czf hbase-conf-$(date +%F).tar.gz $HBASE_HOME/conf $HBASE_HOME/logs
• 部署与切换
  • tar -xzvf hbase-<newver>-bin.tar.gz -C /opt
  • ln -sfn /opt/hbase-<newver> /opt/hbase
• 启动与验证
  • start-hbase.sh
  • http://<master>:16010
  • hbase shell → status、list