TiDB版本升级案例

最近，在线上遇到了一个TiDB版本升级的需求，之前一直没有遇到过，参照官方文档，对已有的几套集群做了下升级，也总结了一些自己的经验，这里分享出来。

一、TiDB版本介绍

TiDB目前最新的版本是5.4版本，推荐使用tiup工具进行部署和维护。而tiup工具是从TiDB4.0版本引进的，因此，从TiDB4.0开始，可以直接使用tiup工具进行直接升级，不需要多次升级，例如下面的升级方案都是可行的：

v4.0 --- v5.4

v4.0 --- v5.3

v4.0 --- v5.2

v4.0 --- v5.1

v4.0 --- v5.0

从上面描述可以看到，版本号我这边只写到第二位，只要大版本号的2位满足上述规则，则可以忽略小版本带来的差异。

相反，如果你的线上TiDB版本是TiDB3.0或者TiDB2.0 ，则需要先将TiDB版本升级到TiDB4.0，然后再升级到TiDB5.x版本，升级过程如下：

v3.0 --- v4.0 ---v5.x

二、TiDB升级须知

升级过程中，有以下必须了解的内容：

1、TiDB的升级过程不可逆，不支持版本降级或者回退，需要根据release note提前做好测试工作

2、如果使用TiDB Ansible管理的TiDB4.0集群，需要将集群导入到tiup工具中来管理，才可以使用tiup进行升级

3、v5.3版本之后，TiDB 内置的prometheus会从默认2.8版本升级到2.27版本

三、TiDB升级前置工作

1、确保没有DDL操作

2、需要确保tiup工具的版本不低于1.9.0

这个可以通过下面命令来执行更新：

tiup update --self来自动更新tiup版本

tiup --version 命令来查看当前tiup的版本

[root@ ~]# tiup --version 
1.9.2 tiup
Go Version: go1.17.7
Git Ref: v1.9.2
GitHash: d90f3eb81e145621c3880c320b88bf10c6f03a70

3、需要确保tiup cluster工具版本不低于1.9.0

这个可以通过下面命令来执行更新：

tiup update cluster来自动更新tiup版本

tiup cluster --version 命令来查看当前tiup的版本

[root@ ~]# tiup cluster --version 
tiup is checking updates for component cluster ...
Starting component `cluster`: /root/.tiup/components/cluster/v1.9.2/tiup-cluster /root/.tiup/components/cluster/v1.9.2/tiup-cluster --version
tiup version 1.9.2 tiup
Go Version: go1.17.7
Git Ref: v1.9.2
GitHash: d90f3eb81e145621c3880c320b88bf10c6f03a70

注意：如果你的服务器不能连接外网，则不能直接使用上述命令，需要在官网下载对应版本的tidb官方社区版本的软件：tidb-community-server，然后进行挤压，并执行其中的本地化安装脚本，从而实现安装，命令如下：

tar xzvf tidb-community-server-${version}-linux-amd64.tar.gz
sh tidb-community-server-${version}-linux-amd64/local_install.sh
source /home/tidb/.bash_profile

4、部分参数修改

如果你的TiDB 版本大于v5.0，而TiDB本身又配置了如下参数：

pessimistic-txn.enabled
server.request-batch-enable-cross-command
server.request-batch-wait-duration

则需要将这些参数注释之后再升级，因为这些参数在v5.0之后，已经取消。

四、TiDB升级步骤

目前，官方给的TiDB升级方案，主要有2种，一种是在线升级，一种是离线升级，默认的方案是在线升级，但是这里推荐采用离线升级，主要有下面几个原因：

1、在线升级对于大数据量不是很友好

这种升级方案，升级过程中集群可以对外提供服务，升级的时候会逐个升级集群的组件，包含tidb、pd、tikv等，对于tikv，牵扯到节点上的leader驱逐，驱逐后再进行升级和重启，当集群中的数据量很多的时候，leader数量也比较多，驱逐时间比较长，而且很容易造成驱逐超时

2、在线升级期间，业务可能会产生抖动问题，存在不确定性

3、离线升级虽然需要停机，但是升级过程只是软件包的替换，跟业务数据量无关，时间比较可控。

下面分别给出在线升级和离线升级的命令：

在线升级：

a、在线升级

tidb cluster upgrate cluster_name version

b、检查升级状态

tiup cluster display cluster_name

离线升级：

a、停服务

tiup cluster stop cluster_name

b、升级

tiup cluster upgrade cluster version --offline

c、启动服务

tiup cluster start cluster_name

d、检查升级状态

tiup cluster display cluster_name

以上就是升级过程中需要注意的问题。如果升级过程失败了，可以根据具体的失败类型来进行处理，详情可以参考：https://docs.pingcap.com/zh/tidb/stable/upgrade-tidb-using-tiup

本次线上升级，采用离线升级方案，升级了3套集群，均未发现异常。