如何在 Debian 上升级 HBase 版本

在 Debian 上升级 HBase 的实操指南

一 升级前准备

• 明确升级路径：确认从当前版本到目标版本的跨度，优先选择相邻稳定版本，跨多版本升级务必先在测试环境演练。
• 核对兼容性：确保新版本与现有 Hadoop、ZooKeeper 兼容；如使用 Phoenix，需同步评估其版本匹配与 JAR 放置策略。
• 完整备份：
  • 备份 HDFS 上的 HBase 根目录（示例）：hdfs dfs -cp -r /hbase /backup/hbase-$(date +%F)；
  • 备份 ZooKeeper 元数据（如使用内置 ZK，注意其数据目录）；
  • 备份配置文件：/usr/local/hbase/conf/（或你的实际安装路径）。
• 准备回滚方案：保留旧版本目录与配置，便于快速回退；准备停机窗口与回滚演练。
• 检查客户端：升级期间禁止新版本客户端连接；升级完成并验证后再统一切换。
• 环境校验：确认 Java 版本满足新 HBase 要求（常见为 OpenJDK 8+），并统一 JAVA_HOME 指向。

二 标准原地升级步骤（适用于大多数版本，含 1.x→2.x 场景）

1. 停机与隔离
   • 停止 HBase：/usr/local/hbase/bin/stop-hbase.sh；
   • 禁止业务写入与客户端连接，避免升级过程中产生新数据。
2. 备份关键数据与配置
   • 备份 HDFS 数据：hdfs dfs -cp -r /hbase /backup/hbase-$(date +%F)；
   • 备份 ZooKeeper 数据（内置 ZK 则备份其 dataDir；外部 ZK 按运维策略备份）；
   • 备份配置：tar czf hbase-conf-$(date +%F).tgz /usr/local/hbase/conf。
3. 下载并部署新版本
   • 下载目标版本（示例）：wget https://archive.apache.org/dist/hbase/2.4.10/hbase-2.4.10-bin.tar.gz；
   • 解压并替换二进制：tar -xzf hbase-2.4.10-bin.tar.gz -C /usr/local/src/ && mv /usr/local/src/hbase-2.4.10 /usr/local/hbase-new；
   • 同步旧配置到新目录：cp -r /usr/local/hbase/conf /usr/local/hbase-new/conf。
4. 调整配置与依赖
   • 在 hbase-env.sh 中设置 JAVA_HOME；
   • 核对 hbase-site.xml 关键项：hbase.rootdir、hbase.zookeeper.quorum、hbase.cluster.distributed 等；
   • 如使用 HDFS，拷贝 core-site.xml、hdfs-site.xml 到 conf/；如使用内置 ZK，核对 hbase.zookeeper.property.dataDir。
5. 执行升级工具（如版本提供）
   • 某些版本支持离线升级命令：/usr/local/hbase-new/bin/hbase upgrade -check（检查）与 ... -execute（执行）；仅在官方文档明确支持时运行。
6. 切换与启动
   • 原子切换（建议）：mv /usr/local/hbase /usr/local/hbase-old && mv /usr/local/hbase-new /usr/local/hbase；
   • 启动：/usr/local/hbase/bin/start-hbase.sh。
7. 验证
   • 版本：/usr/local/hbase/bin/hbase version；
   • 集群：echo "status" | hbase shell 或 hbase shell 中执行 status 'detailed'；
   • 业务回归：抽样读写、检查 HMaster/HRegionServer 日志无异常。

三 特殊升级场景与注意事项

• 使用 HBase 备份/恢复工具
  • 若新版本支持，可用 hbase backup create full 进行全量备份，升级后在 hbase shell 中执行 restore 恢复；适合跨小版本或跨维护窗口的平滑过渡。
• 使用快照迁移（跨集群/跨环境）
  • 通过 snapshot 导出再在目标集群 clone/snapshot-restore，对业务影响小，适合复杂升级或迁移。
• 使用 HFiles 导入（Bulk Load 场景）
  • 旧集群导出 HFiles，新集群用 LoadIncrementalHFiles 导入，适合大数据量且可接受短暂导入窗口的场景。
• 回滚策略
  • 启动失败或数据异常：快速回退二进制与配置（mv /usr/local/hbase /usr/local/hbase-failed && mv /usr/local/hbase-old /usr/local/hbase），必要时恢复 HDFS 备份与 ZK 数据。
• 客户端与兼容性
  • 升级完成并通过健康检查后再统一发布新客户端；确保 Hadoop/ZooKeeper 版本与新 HBase 匹配，避免 API/行为变更导致应用异常。

四 快速命令清单（可按需裁剪）

• 备份 HDFS 数据：hdfs dfs -cp -r /hbase /backup/hbase-$(date +%F)
• 停止 HBase：/usr/local/hbase/bin/stop-hbase.sh
• 下载与部署：wget https://archive.apache.org/dist/hbase/2.4.10/hbase-2.4.10-bin.tar.gz && tar -xzf hbase-2.4.10-bin.tar.gz -C /usr/local/src/ && mv /usr/local/src/hbase-2.4.10 /usr/local/hbase-new
• 同步配置：cp -r /usr/local/hbase/conf /usr/local/hbase-new/conf
• 升级检查/执行（若支持）：/usr/local/hbase-new/bin/hbase upgrade -check 与 ... -execute
• 切换与启动：mv /usr/local/hbase /usr/local/hbase-old && mv /usr/local/hbase-new /usr/local/hbase && /usr/local/hbase/bin/start-hbase.sh
• 验证：/usr/local/hbase/bin/hbase version、echo "status" | hbase shell