当你在试着升级 HBase 的时候,你可能会遇到升级失败的问题,并且想要将其恢复成之前的版本。本节就介绍如何执行 _ 回滚 _ 以将 HBase 恢复为到较早的版本。请注意,这应该只在主要版本和一些次要版本之间需要。您应该始终能够在相同次要版本的 HBase Patch 版本之间进行 _ 降级 _。这些说明可能要求您在开始升级过程之前注意相关的事项,因此请务必事先阅读本节。
回滚与降级
本节介绍如何对 HBase 次要版本和主要版本之间的升级执行回滚。在本文档中,回滚指的是采取升级后的集群并将其恢复到旧版本的过程,同时 _ 丢失升级后发生的所有更改 _。相比之下,群集降级会将升级后的群集恢复到旧版本,同时保留升级后写入的任何数据。我们目前仅提供回滚 HBase 集群的说明。此外,只有在执行升级之前遵循这些说明,回滚才有效。
当这些指令谈论回滚与降级的先决条件群集服务(即 HDFS)时,您应该将服务版本与退化的降级案例视为相同。
复制
除非您正在执行全部服务回滚,否则 HBase 群集将会丢失任何配置的对等 HBase 复制。如果您的集群配置为 HBase 复制,那么在按照这些说明Managing and Configuring Cluster Replication进行操作之前,您应该记录所有复制节点。执行回滚之后,您应该将每个记录的对等点添加回群集。另外要注意,自升级后写入群集的数据可能已经或可能未被复制到任何对等方。
数据位置
除非您正在执行全部服务回滚,否则通过回滚过程可能会破坏 Region Server 的所有局部位置。在群集有时间通过紧凑排列恢复数据位置之前,您应该期望性能的降级。或者,您可以强制压缩来加速此过程,但要以生成群集负载为代价。
可配置的位置
以下说明假设 HBase 数据目录和 HBase znode 的默认位置。这两个位置都是可配置的,您应该在继续操作之前验证群集中使用的值。如果您有不同的值,只需将默认值替换为在配置中找到的 HBase 数据目录,它是通过密钥 "HBase" (rootdir) 配置的,并且具有默认的 "/HBase"。* HBase znode 通过密钥'zookeeper.znode.parent'进行配置,默认值为'/ hbase'。
如果您要执行 HDFS 和 ZooKeeper 服务的回滚,那么 HBase 的数据将在此过程中回滚。
要求
升级前
在升级前不需要额外的步骤。作为一项额外的预防措施,您可能希望使用 distcp 将 HBase 数据备份到要升级的群集之外。为此,请本节内容中的按照“HDFS 降级后回滚”的“升级前”部分中的步骤操作,但它是复制到另一个 HDFS 实例,而不是在同一实例中。
执行回滚
停止 HBase
执行 HDFS 和 ZooKeeper 的回滚(HBase 应该保持停止状态)
将安装的 HBase 版本更改为以前的版本
启动 HBase
验证 HBase 内容 - 使用 HBase shell 列出表格并扫描一些已知值。
如果您将回滚 HDFS,但通过 ZooKeeper 降级,那么 HBase 将处于不一致的状态。在完成此过程之前,您必须确保集群未启动。
要求
能够回滚 HDFS
能够降级 ZooKeeper
升级前
在升级前不需要额外的步骤。作为一种额外的预防措施,您可能希望使用 distcp 将 HBase 数据备份到要升级的群集之外。为此,请本节内容中的按照“HDFS 降级后回滚”的“升级前”部分中的步骤操作,但它将复制到另一个 HDFS 实例,而不是在同一实例中。
执行回滚
停止 HBase
执行 HDFS 回滚和 ZooKeeper 降级(HBase 应该保持停止状态)
将安装的 HBase 版本更改为以前的版本
清除与 HBase 相关的 ZooKeeper 信息。警告:此步骤将永久销毁所有复制对等点。
清理 ZooKeeper 中的 HBase 信息
[hpnewton@gateway_node.example.com ~]$ zookeeper-client -server zookeeper1.example.com:2181,zookeeper2.example.com:2181,zookeeper3.example.com:2181
Welcome to ZooKeeper!
JLine support is disabled
rmr /hbase
quit
Quitting...
启动 HBase
验证 HBase 内容 - 使用 HBase shell 列出表格并扫描一些已知值。
如果您要执行 HDFS 降级,则无论 ZooKeeper 是否通过回滚、降级或重新安装,您都需要遵循这些指示信息。
要求
可以降级 HDFS
升级前群集必须能够运行 MapReduce 作业
HDFS 超级用户访问
在 HDFS 中至少有两个 HBase 数据目录的副本空间可以降级 HDFS
升级前
在开始升级过程之前,您必须对 HBase 的支持数据进行完整备份。以下说明介绍了在当前 HDFS 实例中备份数据的过程。或者,您可以使用 distcp 命令将数据复制到另一个 HDFS 群集。
停止 HBase 群集
将 HBase 数据目录复制到备份位置, 方法distcp command是使用 distcp 命令作为 HDFS 超级用户 (下面显示在启用安全的群集上)
使用 distcp 备份 HBase 数据目录:
[hpnewton@gateway_node.example.com ~]$ kinit -k -t hdfs.keytab hdfs@EXAMPLE.COM
[hpnewton@gateway_node.example.com ~]$ hadoop distcp /hbase /hbase-pre-upgrade-backup
Distcp 将启动一个 mapreduce 作业来处理以分布式方式复制文件。检查 distcp 命令的输出,以确保此作业成功完成。
执行回滚
停止 HBase
执行 HDFS 的降级和 ZooKeeper 的降级/回滚(HBase 应该保持停止状态)
将安装的 HBase 版本更改为以前的版本
将 HBase 数据目录从升级前恢复为 HDFS 超级用户 (如下所示在启用安全的群集上)。如果您将数据备份到另一个 HDFS 群集而不是本地,则需要使用 distcp 命令将其复制回当前的 HDFS 群集。 恢复 HBase 数据目录:
[hpnewton@gateway_node.example.com ~]$ kinit -k -t hdfs.keytab hdfs@EXAMPLE.COM
[hpnewton@gateway_node.example.com ~]$ hdfs dfs -mv /hbase /hbase-upgrade-rollback
[hpnewton@gateway_node.example.com ~]$ hdfs dfs -mv /hbase-pre-upgrade-backup /hbase
清除与 HBase 相关的 ZooKeeper 信息。警告:此步骤将永久销毁所有复制对等点。
清理 ZooKeeper 中的 HBase 信息:
[hpnewton@gateway_node.example.com ~]$ zookeeper-client -server zookeeper1.example.com:2181,zookeeper2.example.com:2181,zookeeper3.example.com:2181
Welcome to ZooKeeper!
JLine support is disabled
rmr /hbase
quit
Quitting...
启动 HBase
验证 HBase 内容 - 使用 HBase shell 列出表格并扫描一些已知值。