温馨提示×

centos怎么升级hbase

小樊
42
2026-09-18 12:42:43
栏目: 智能运维

在 CentOS 上升级 HBase 一般分为:准备 → 停止服务 → 备份 → 替换软件 → 升级元数据 → 验证。下面给你一套通用、稳妥的升级步骤(以 tarball 安装为例,适用于大多数生产环境)。


一、升级前准备

1. 查看当前版本

hbase version

或

cat $HBASE_HOME/lib/hbase-common-*.jar | grep -a "Version"

2. 确认兼容关系(非常重要)

HBase 升级必须参考官方文档:

  • HBase 1.x → 2.x
  • HBase 2.1 → 2.4
  • HBase 2.4 → 2.5

⚠️ 大版本升级(如 1.x → 2.x)必须看官方 Upgrade Notes

官方文档:

https://hbase.apache.org/book.html#upgrading

二、停止 HBase 服务

$HBASE_HOME/bin/stop-hbase.sh

确认已完全停止:

jps | grep HMaster
jps | grep HRegionServer

三、备份(必须做)

1. 备份 HDFS 数据(最关键)

hdfs dfs -mkdir /hbase-backup-$(date +%F)
hdfs dfs -cp /hbase /hbase-backup-$(date +%F)/hbase

2. 备份配置文件

cp -r $HBASE_HOME/conf /opt/hbase-conf-backup

3. (可选)snapshot 备份表

hbase shell
snapshot 'table_name', 'snapshot_20250101'

四、下载并替换 HBase

cd /opt
wget https://archive.apache.org/dist/hbase/2.5.8/hbase-2.5.8-bin.tar.gz
tar -zxvf hbase-2.5.8-bin.tar.gz

例如旧版本是:

/opt/hbase-2.4.0

新版本:

/opt/hbase-2.5.8

五、迁移配置文件

不要直接覆盖 conf 目录,手动合并:

cp /opt/hbase-conf-backup/hbase-site.xml /opt/hbase-2.5.8/conf/
cp /opt/hbase-conf-backup/hbase-env.sh /opt/hbase-2.5.8/conf/
cp /opt/hbase-conf-backup/regionservers /opt/hbase-2.5.8/conf/

⚠️ 注意:

  • 新版本可能新增配置项
  • 检查 hbase-site.xml 是否有废弃参数

六、更新环境变量

vi /etc/profile

修改:

export HBASE_HOME=/opt/hbase-2.5.8

使生效:

source /etc/profile

七、升级 HBase 元数据(关键)

1. 启动 HBase

$HBASE_HOME/bin/start-hbase.sh

2. 执行升级命令

hbase upgrade

或(旧版本):

hbase hbck -fixMeta

3. 检查集群状态

hbase shell
status

八、验证升级

hbase version

检查日志:

tail -f $HBASE_HOME/logs/hbase-*.log

九、常见注意事项

✅ 小版本升级(2.4 → 2.5)

  • 可直接替换
  • 基本无需 schema 变更

❌ 大版本升级(1.x → 2.x)

  • 必须升级 HDFS / ZooKeeper
  • 需执行 hbase upgrade
  • 客户端代码可能不兼容

十、回滚方案(以防万一)

stop-hbase.sh
hdfs dfs -rm -r /hbase
hdfs dfs -cp /hbase-backup-20250101/hbase /hbase

恢复旧 HBASE_HOME 并启动。


如果你能告诉我:

  • 当前 HBase 版本
  • 目标版本
  • 是否使用 CDH / HDP / 原生安装

我可以给你精确到命令的升级方案。

0 踩