升级 StarRocks
本文介绍如何升级您的 StarRocks 集群。
概述
请在升级前查看本节中的信息。建议您按照文中推荐的操作升级集群。
StarRocks 版本
StarRocks 的版本号由三个数字表示,格式为 Major.Minor.Patch,例如 2.5.4
。第一个数字代表 StarRocks 的重大版本,第二个数字代表大版本,第三个数字代表小版本。
注意
请注意,已有存算一体集群无法直接升级为存算分离集群,反之亦然。您需要重新部署一套存算分离集群。
升级路径
-
小版本升级
您可以跨小版本升级您的 StarRocks 集群,例如,从 v2.2.6 直接升级到 v2.2.11。
-
大版本升级
从 StarRocks v2.0 开始,您可以跨大版本升级 StarRocks 集群,例如,从 v2.2.x 直接升级到 v2.5.x。但出于兼容性和安全原因,我们强烈建议您将 StarRocks 集群按大版本逐级升级。例如,要将 StarRocks v2.2 集群升级到 v2.5,需要按照以下顺序升级:v2.2.x --> v2.3.x --> v2.4.x --> v2.5.x。
-
重大版本升级
- 您必须从 v1.19 升级到 v2.0。
- 您必须从 v2.5 升级到 v3.0。
注意
如果您需要进行连续的大版本升级,比如从 2.4->2.5->3.0->3.1->3.2,或者在升级之后进行了降级,之后再次执行升级,比如 2.5->3.0->2.5->3.0。为了避免部分 FE 节点元数据升级失败,需要在相邻的两次升级之间或降级后升级前执行如下操作:
- 执行 ALTER SYSTEM CREATE IMAGE 创建新的元数据快照文件。
- 等待元数据快照文件同步至其他 FE 节点。
您可以通过查看 Leader FE 节点的日志文件 fe.log 确认元数据快照文件是否推送完成。如果日志打印以下内容,则说明快照文件推送完成:"push image.xxx from subdir [] to other nodes. totally xx nodes, push succeeded xx nodes"。