centos hbase更新升级流程
小樊
40
2025-12-21 18:18:57
CentOS 上 HBase 升级流程
一 升级前准备
- 明确升级路径：确认是从 HBase 2.x → 2.y 的小版本升级，还是 2.x → 3.x 的跨大版本升级。跨大版本通常不建议滚动升级，需按官方说明进行离线升级与数据迁移。
- 兼容性核对：严格核对 HBase 与 Hadoop、ZooKeeper 的版本矩阵，避免因不兼容导致 HMaster 无法启动 等问题（如 Hadoop 版本不匹配会直接报错并退出）。
- 完整备份：备份 HBase 数据目录（如 HDFS 上的 HBase 根目录）、本地配置与日志，并导出关键表结构或快照，确保可回滚。
- 配置与客户端梳理：梳理 hbase-site.xml、hbase-env.sh、regionservers 等关键配置；规划客户端升级节奏，避免升级过程中新旧客户端混用。
- 测试验证：在 测试环境 完整演练升级与回滚，覆盖核心业务表的读写、压缩/合并、权限与配额等关键场景。
二 标准升级步骤
- 检查运行状态并优雅停机
- 使用 jps 确认 HMaster、HRegionServer 进程正常；执行 stop-hbase.sh 完成集群停机。
- 备份关键数据与配置
- 备份 HDFS 上的 HBase 数据 与 本地配置/日志，保留可快速回滚的副本。
- 下载并部署新版本
- 从 Apache HBase 官方发布页 下载目标版本，解压至目标目录（如 /opt/hbase-新版本），保留旧版本目录以便回滚。
- 同步与调整配置
- 将旧版的 conf/ 目录整体拷贝到新版本，按需调整 hbase-env.sh（如 JAVA_HOME）、hbase-site.xml（如 hbase.rootdir、ZooKeeper 地址）、regionservers 等；如新版本引入新参数或默认值变化，按官方说明更新。
- 启动与版本核验
- 执行 start-hbase.sh 启动集群；使用 hbase version 与 HBase Shell 验证进程与基本读写是否正常。
- 观察与回滚预案
- 重点观察 HMaster/RegionServer 日志 与 HDFS 使用情况；若出现异常，按备份快速回滚到旧版本并恢复配置。
三 关键注意事项
- 兼容性第一：升级前必须核对 HBase–Hadoop–ZooKeeper 的版本兼容矩阵；不兼容会导致启动失败或运行期异常。
- 配置与目录：升级后优先复用旧配置并逐项校验，避免因 ZooKeeper 地址、根目录、端口 变化引发连接或数据路由问题。
- 客户端一致性：升级期间避免新客户端访问；待集群稳定后再统一升级客户端依赖与 SDK。
- 日志与监控：升级后重点查看 $HBASE_HOME/logs 中的 HMaster/RegionServer 日志，配合 jps 与 UI 检查服务健康度。
- 回滚策略：保留旧版本目录与 HDFS 数据快照/备份，一旦出现异常可快速回滚并恢复业务。
四 常见问题与快速排查
- HMaster 无法启动（Hadoop 版本不兼容）
- 现象：启动即退出，日志提示 Hadoop version incompatible。
- 处理：核对 HBase 与 Hadoop 版本矩阵，必要时调整至兼容版本或重新部署对应 Hadoop 版本。
- 客户端连接超时或拒绝
- 处理：确认 HMaster/RegionServer 进程已启动（jps），核对 hbase-site.xml 的 ZooKeeper 地址/端口 与网络连通性（如 telnet zk_host 2181），并检查客户端与服务端版本一致。
- 升级后行为异常
- 处理：查看 $HBASE_HOME/logs/hbase-*.log 定位错误；回滚到旧版本并复核新版本变更点与配置差异。
