centos hbase版本升级
小樊
43
2025-12-19 19:21:53
CentOS 上 HBase 版本升级实操指南
一 升级前准备
- 明确升级路径：HBase 自 1.0.0 起采用语义化版本，跨 MAJOR 版本通常不能直接升级，需要按中间版本逐步升级；例如从 0.98.x → 2.x 需先到 1.2.x 再到 2.x。升级前务必阅读目标版本的发行说明与兼容性矩阵。
- 兼容性核对：确认新版本与现有 Hadoop、ZooKeeper、JDK 的兼容性；必要时先升级依赖或调整版本策略。
- 完整备份：备份 HBase 数据目录（如 HDFS 上的 hbase.rootdir）、本地 WAL/日志、以及 配置文件（hbase-site.xml、hbase-env.sh、regionservers 等），以便快速回滚。
- 预检与演练：在测试环境全量演练升级与回滚流程，覆盖关键业务表与常见故障场景。
- 客户端策略：升级期间避免新旧客户端混用；若必须并行，遵循“先服务端升级、后客户端升级”的顺序，且确认是否支持滚动升级。
二 标准升级步骤
- 停止集群：在全部节点执行优雅停机，建议使用 $HBASE_HOME/bin/stop-hbase.sh，确认 HMaster/RegionServer 进程已退出。
- 安装新版本：下载目标版本二进制包并解压到目标目录（如 /opt/hbase-<新版本>），保留旧版本目录以便回滚。
- 迁移配置：将旧版 conf/ 下必要配置拷入新版（建议逐项比对而非全量覆盖），重点检查 hbase-site.xml 的 hbase.rootdir、hbase.zookeeper.quorum、hbase.cluster.distributed 等关键项；按需更新 hbase-env.sh 中的 JAVA_HOME 与内存参数。
- 启动与验证：先启动 HMaster，确认稳定后再启动 RegionServer；执行 hbase version 与 HBase Shell 基本 DDL/DML 验证读写是否正常，并观察 Master/RegionServer 日志与 HBase Web UI。
- 回滚预案：若验证失败，停止新版本，恢复旧版目录与配置，必要时恢复备份数据后重启。
三 滚动升级与兼容性要点
- 何时可滚动：仅当目标版本与现网在“二进制/线路协议”上兼容时才支持滚动升级；通常 MINOR 版本之间可滚动，MAJOR 版本多需停机升级（以发行说明为准）。
- 推荐顺序：先升级 HMaster（可先停一台备 Master，升级后再切换），再逐台升级 RegionServer；滚动期间保持业务低峰或短暂中断。
- 客户端与 ZK：升级过程中避免新客户端连入；确保 ZooKeeper 集群健康且版本兼容。
- 回滚限制：同一次要版本内的 PATCH 通常可降级；跨 MAJOR/MINOR 回滚往往仅能“回滚”（丢失升级后数据），且需提前准备回滚方案与备份。
四 常见故障排查
- HMaster 无法启动：多因配置错误或 ZooKeeper 异常；检查 hbase-site.xml 的 hbase.rootdir 与 ZooKeeper 地址、目录权限；必要时清理 logs/、tmp/ 后重启，并查看 Master 启动日志定位根因。
- Region 无法上线：可能因主机名变更或 hbase:meta 不一致；在 HBase Shell 执行 scan ‘hbase:meta’ 排查异常 Region，必要时用 hbase hbck -fixAssignments
修复分配，再运行 hbase hbck 复核一致性。
- 客户端连接超时：优先使用主机名并确保 /etc/hosts 或 DNS 解析一致；检查 ZooKeeper 会话超时与网络连通性。
- 升级后读写异常：核对新旧客户端 API 差异与兼容性；若启用协处理器/过滤器等插件，确认其与新版本二进制兼容并重新编译部署。
五 版本路径与回滚建议
- 路径规划：严格按发行说明的兼容性执行跨版本升级，不能跳过中间 MAJOR 版本；例如 0.98.x → 2.x 需经 1.2.x 中转。
- 回滚策略：跨版本回滚通常仅支持“回滚到升级前状态并丢失新数据”；务必在升级前完成数据与元数据的全量备份，并准备一键回滚脚本与流程演练。