一、升级 TiUP
1. 先升级 TiUP 版本(建议 tiup 版本不低于 1.5.0): tiup update --self tiup --version 2. 再升级 TiUP Cluster 版本(建议 tiup cluster 版本不低于 1.5.0): tiup update cluster tiup cluster --version
注意:
在升级的过程中不要执行 DDL 请求,否则可能会出现行为未定义的问题。
二、编辑 TiUP Cluster 拓扑配置文件
注意: 以下情况可跳过此步骤: 原集群没有修改过配置参数,或通过 tiup cluster 修改过参数但不需要调整。 升级后对未修改过的配置项希望使用 5.2 默认参数。
1. 进入拓扑文件的 vi
编辑模式:
tiup cluster edit-config <cluster-name>
三、检查当前集群的健康状况
为避免升级过程中出现未定义行为或其他故障,建议在升级前对集群当前的 region 健康状态进行检查,此操作可通过 check
子命令完成。
tiup cluster check <cluster-name> --cluster
四、将集群升级到指定版本
升级的方式有两种:不停机升级和停机升级。TiUP Cluster 默认的升级 TiDB 集群的方式是不停机升级,即升级过程中集群仍然可以对外提供服务。升级时会对各节点逐个迁移 leader 后再升级和重启,因此对于大规模集群需要较长时间才能完成整个升级操作。如果业务有维护窗口可供数据库停机维护,则可以使用停机升级的方式快速进行升级操作。
tiup cluster upgrade <cluster-name> <version>
以升级到 5.2.1 版本为例:
tiup cluster upgrade <cluster-name> v5.2.1
五、升级后验证
执行 display 命令来查看最新的集群版本 TiDB Version tiup cluster display <cluster-name>