Doris 升级手册

说明

Doris 可以通过滚动升级的方式,平滑进行升级。建议按照以下步骤进行安全升级。
Doris不支持跨两位版本号进行升级,例如:不能从0.13直接升级到0.15,只能通过0.13.x -> 0.14.x -> 0.15.x,三位版本号可以跨版本升级,比如从0.13.15可以直接升级到0.14.13.1,不必一定要升级0.14.7 或者 0.14.12.1这种版本。具体版本差距可以在官网 image.png 查询。

这里升级为 1.2.1 -> 2.0 版本

前置工作

  • 关闭集群副本修复和均衡功能

升级过程中会有节点重启,所以可能会触发不必要的集群均衡和副本修复逻辑。可以先通过以下命令关闭:

# 关闭副本均衡逻辑。关闭后,不会再触发普通表副本的均衡操作。
$ mysql-client > admin set frontend config("disable_balance" = "true");

# 关闭 colocation 表的副本均衡逻辑。关闭后,不会再触发 colocation 表的副本重分布操作。
$ mysql-client > admin set frontend config("disable_colocate_balance" = "true");

# 关闭副本调度逻辑。关闭后,所有已产生的副本修复和均衡任务不会再被调度。
$ mysql-client > admin set frontend config("disable_tablet_scheduler" = "true");

当集群升级完毕后,在通过以上命令将对应配置设为原值即可。

  • 在升级之前需要备份元数据(整个目录都需要备份)!!

升级

BE 节点

  1. 任意选择一个 BE 节点,部署最新的 doris_be 二进制文件。
  2. 重启 BE 节点,通过 BE 日志 be.INFO,查看是否启动成功。
  3. 如果启动失败,可以先排查原因。如果错误不可恢复,可以直接通过 DROP BACKEND 删除该 BE、清理数据后,使用上一个版本的 doris_be 重新启动 BE。然后重新 ADD BACKEND。(该方法会导致丢失一个数据副本,请务必确保3副本完整的情况下,执行这个操作!!!
  4. 安装 Java UDF 函数 1.2.0 版本后需要,安装 Java UDF 函数:, 因为从1.2 版本开始支持Java UDF 函数,需要从官网下载 Java UDF 函数的 JAR 包放到 BE 的 lib 目录下,否则可能会启动失败。

测试升级启动成功。
image.png

测试 FE 元数据兼容性

  1. 重要!!元数据兼容性异常很可能导致数据无法恢复!!
  2. 单独使用新版本部署一个测试用的 FE 进程(建议在自己本地的开发机,或者BE节点。如果在Follower或者Observer节点上,需要停止启动的进程,但是不建议在Follower或者Observer节点上测试)。
  3. 修改测试用的 FE 的配置文件 fe.conf,将所有端口设置为与线上不同
  4. 在 fe.conf 添加配置:cluster_id=123456
  5. 在 fe.conf 添加配置:metadata_failure_recovery=true
  6. 拷贝线上环境 Master FE 的元数据目录 doris-meta 到测试环境
  7. 将拷贝到测试环境中的 doris-meta/image/VERSION 文件中的 cluster_id 修改为 123456(即与第3步中相同)

image.png

  1. 在测试环境中,运行 sh bin/start_fe.sh 启动 FE
  2. 通过 FE 日志 fe.log 观察是否启动成功。这里可以正常启动应该就没问题至于某些节点拒绝链接可以忽略
  3. 如果启动成功,运行 sh bin/stop_fe.sh 停止测试环境的 FE 进程。
  4. 以上 2-6 步的目的是防止测试环境的FE启动后,错误连接到线上环境中。

测试升级 FE 成功。
image.png

升级准备

  1. 在完成数据正确性验证后,将 BE 和 FE 新版本的二进制文件分发到各自目录下。
  2. 原则上版本升级需要替换 FE 和 BE 除 conf 目录、数据目录(FE 的 doris-meta,BE 的 storage)、log 目录外的其他目录。

升级

  1. 确认新版本的文件部署完成后。逐台重启 FE 和 BE 实例即可。
  2. 建议逐台重启 BE 后,再逐台重启 FE。因为通常 Doris 保证 FE 到 BE 的向后兼容性,即老版本的 FE 可以访问新版本的 BE。但可能不支持老版本的 BE 访问新版本的 FE。
  3. 建议确认前一个实例启动成功后,再重启下一个实例。实例启动成功的标识,请参阅安装部署文档。

  • 2
    点赞
  • 3
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值