linux hbase如何升级

下面给你一份Linux 环境下 HBase 升级的通用、稳妥操作指南，适用于 HBase 1.x → 2.x 或 2.x 小版本升级 的常见场景（以 Apache HBase 为例，CDH/HDP 类似但需结合官方文档）。

一、升级前准备（非常重要）

1. 明确当前环境

hbase version
hadoop version
java -version

确认：

HBase 版本
Hadoop 版本（HBase 2.x 对 Hadoop 有要求）
JDK 版本（HBase 2.x 建议 JDK 8+）

2. 查阅官方兼容性

HBase Release Notes
HBase 官方升级文档
https://hbase.apache.org/book.html#upgrade

3. 备份（必做）

# HDFS 数据备份
hdfs dfs -copyToLocal /hbase /backup/hbase-$(date +%F)

# 配置文件备份
cp -r $HBASE_HOME/conf /backup/hbase-conf-$(date +%F)

4. 停止 HBase

stop-hbase.sh

确认进程已退出：

jps | grep HMaster
jps | grep HRegionServer

二、升级方式选择

方式一：滚动升级（仅小版本，如 2.4.1 → 2.4.17）

适合：

2.x → 2.x
无重大格式变更

方式二：停机升级（推荐、最安全）

适合：

1.x → 2.x
跨大版本

三、停机升级步骤（推荐）

1. 下载新版本

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

2. 复制配置文件

cp /backup/hbase-conf-2026-01-21/* /opt/hbase-2.4.17/conf/

注意检查：

hbase-site.xml
regionservers
hbase-env.sh

3. 修改环境变量

vim /etc/profile
export HBASE_HOME=/opt/hbase-2.4.17
export PATH=$HBASE_HOME/bin:$PATH
source /etc/profile

四、HBase 2.x 特殊升级步骤（1.x → 2.x）

1. 执行前置升级（关键）

hbase upgrade -check
hbase upgrade -execute

2. 启动 HBase

start-hbase.sh

3. 查看日志

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

五、升级后验证

1. 状态检查

hbase shell
status

2. 表检查

list
scan 'test_table', {LIMIT => 1}

3. HBCK2（2.x 推荐）

hbase hbck -j hbase-hbck2.jar

六、常见坑提醒

✅ 不要直接覆盖旧 HBase 目录
✅ Hadoop 版本不匹配会直接启动失败
✅ ZooKeeper 数据建议保留，不要删
✅ HBase 2.x 默认使用 Procedure V2

七、如果你用的是 CDH / HDP

请告诉我：

CDH 版本
HBase 当前版本

我可以给你对应平台的升级路径（Cloudera Manager / Ambari）。

如果你愿意，可以告诉我：

当前 HBase 版本
Hadoop 版本
单机 / 集群
是否生产环境

我可以给你定制化升级方案。