CentOS HBase版本选择与升级策略

版本选择建议

• 优先选择 HBase 2.x 的最新稳定小版本（如 2.3.x/2.4.x 中的稳定补丁），在 CentOS 7.x 上运行稳定，功能与生态整合更完善；若已有 Hadoop 2.x 且改造代价高，可考虑 HBase 1.2.x 作为过渡，但长期建议规划升级到 2.x。
• 基础环境建议：JDK 1.8+、Hadoop 2.7.x/3.x（与所选 HBase 版本匹配）、ZooKeeper 3.4.x；HBase 1.0.0 之后要求 ZooKeeper ≥ 3.4.x。
• 典型组合示例：CentOS 7.5 + Hadoop 3.2.1 + HBase 2.3.5 + ZooKeeper 3.4.9（经实践验证可行）。
• 兼容性核对优先级：HBase ↔ Hadoop 的版本矩阵（官方支持矩阵）、HBase ↔ ZooKeeper（≥3.4.x）、客户端与服务端 API/线协议兼容性（影响滚动升级与回退）。

版本选择决策表

升级策略与路径

• 升级前准备
  • 完整备份：HDFS 上 HBase 根目录、ZooKeeper znode、重要配置文件；在测试环境演练全链路。
  • 兼容性评估：核对目标版本与 Hadoop/ZooKeeper 的兼容矩阵与发行说明；评估 API/线协议/文件格式 变化对客户端、协处理器、复制、BulkLoad 的影响。
  • 客户端治理：升级期间避免新旧客户端混用；升级完成后再统一切换到新客户端。
• 升级路径与方式
  • 跨大版本不可跳级：例如 0.98.x → 2.x 需先到 1.2.x，再到 2.x。
  • 滚动升级（推荐，适用于线/二进制兼容的相邻版本）：按顺序先升级 HMaster，再逐台升级 RegionServer；Region 在重启前会迁移，尽量降低业务中断。
  • 停机升级（适用于不兼容或发行版限制）：按序停服务→替换安装包→校核配置→启动→验证。
• 发行版注意事项
  • 使用 CDH/HDP 等发行版时，通常需按发行版自身的升级路径执行，且可能不支持直接从 CDH 5 → CDH 6 的逐步升级，需评估迁移或重建方案。
• 升级后验证与回退预案
  • 基本校验：hbase version、HBase Shell 读写、Web UI、复制/Region 均衡状态。
  • 一致性检查：使用 hbck 修复分配/不一致问题；异常时按预案回退到备份或上一稳定版本。

关键注意事项

• 配置与网络
  • 配置文件中优先使用主机名而非 IP，避免 ZooKeeper 连接超时与 Region 上线异常。
  • 核对 hbase.rootdir、hbase.zookeeper.quorum 等关键参数；关注新版本默认端口或行为变化。
• 客户端与 API
  • 升级期间禁止新版本客户端访问；升级完成后再统一发布新客户端。
  • 协处理器/过滤器等依赖 LimitedPrivate/Private API 的组件需按目标版本重新编译与回归测试。
• 常见故障速查
  • HMaster 启动失败/Region 无法上线：检查 ZooKeeper 状态、主机名映射、目录权限；必要时优化初始化与超时参数。
  • hbck 不一致：使用 hbck -fixAssignments 等修复分配，再复核一致性。
  • 连接丢失/超时：核查 ZooKeeper 会话超时、网络连通性与 DNS/hosts 配置。