集群升级

Doris 可以通过滚动升级的方式，平滑进行升级。建议按照以下步骤进行安全升级。

注：

  1. 以下方式均建立在高可用部署的情况下。即数据 3 副本，FE 高可用情况下。

测试 BE 升级正确性

  1. 任意选择一个 BE 节点，部署最新的 palo_be 二进制文件。
  2. 重启 BE 节点，通过 BE 日志 be.INFO，查看是否启动成功。
  3. 如果启动失败，可以先排查原因。如果错误不可恢复，可以直接通过 DROP BACKEND 删除该 BE、清理数据后，使用上一个版本的 palo_be 重新启动 BE。然后重新 ADD BACKEND。（该方法会导致丢失一个数据副本，请务必确保3副本完整的情况下，执行这个操作！！！）

测试 FE 元数据兼容性

  1. 重要！!元数据兼容性异常很可能导致数据无法恢复！！
  2. 单独使用新版本部署一个测试用的 FE 进程（比如自己本地的开发机）。
  3. 修改测试用的 FE 的配置文件 fe.conf，将所有端口设置为与线上不同。
  4. 在 fe.conf 添加配置：cluster_id=123456
  5. 在 fe.conf 添加配置：metadata_failure_recovery=true
  6. 拷贝线上环境 Master FE 的元数据目录 palo-meta 到测试环境
  7. 将拷贝到测试环境中的 palo-meta/image/VERSION 文件中的 cluster_id 修改为 123456（即与第3步中相同）
  8. 在测试环境中，运行 sh bin/start_fe.sh 启动 FE
  9. 通过 FE 日志 fe.log 观察是否启动成功。
  10. 如果启动成功，运行 sh bin/stop_fe.sh 停止测试环境的 FE 进程。
  11. 以上 2-6 步的目的是防止测试环境的FE启动后，错误连接到线上环境中。

升级准备

  1. 在完成数据正确性验证后，将 BE 和 FE 新版本的二进制文件分发到各自目录下。
  2. 通常小版本升级，BE 只需升级 palo_be；而 FE 只需升级 palo-fe.jar。如果是大版本升级，则可能需要升级其他文件（包括但不限于 bin/ lib/ 等等）如果你不清楚是否需要替换其他文件，建议全部替换。

滚动升级

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