问题描述
如何 将TiDB v6.1.0 集群升级到v6.5.1？
过程分析
1) 下载离线镜像；
2) 合并镜像；
3) 将TiDB v6.1.0 集群升级到v6.5.1；
4) 升级组件；
解决方法
1. 环境说明
1.1. 目标：
1) 下载离线镜像；
2) 合并镜像；
3) 将TiDB v6.1.0 集群升级到v6.5.1；
4) 升级组件；
1.2. 当前集群信息
当前设置的本地mirror信息：
[root@tidb30 soft]# tiup mirror show;
/tidb-data/tiupmirror
2. TiDB 离线升级
2.1. TiFlash配置
社区内见过诸多因 TiFlash 导致升级失败的案例。因此，为安全起见建议先将 TiFlash 节点缩容后再升级 TiDB 集群。待升级成功后，再扩容 TiFlash 节点。
关于 TiFlash 升级的更多注意事项，可参考官方链接：https://docs.pingcap.com/zh/tidb/stable/tiflash-620-upgrade-guide
2.2. 离线镜像准备
2.2.1. 下载 6.5.1 离线包
# cd /soft
# export version=v6.5.1 && wget https://download.pingcap.org/tidb-community-server-${version}-linux-amd64.tar.gz
# wget https://download.pingcap.org/tidb-community-toolkit-${version}-linux-amd64.tar.gz
# chown tidb:tidb tidb-community-*-${version}-linux-amd64.tar.gz
2.2.2. 部署 TiUP 组件
# tar -xzvf tidb-community-server-${version}-linux-amd64.tar.gz
# tar -xzvf tidb-community-toolkit-${version}-linux-amd64.tar.gz
# chown -R tidb:tidb tidb-community-*
# sh tidb-community-server-${version}-linux-amd64/local_install.sh
执行输出如下：
[root@tidb30 soft]# sh tidb-community-server-v6.5.1-linux-amd64/local_install.sh
Disable telemetry success
Successfully set mirror to /soft/tidb-community-server-v6.5.1-linux-amd64
Detected shell: bash
Shell profile: /root/.bash_profile
Installed path: /root/.tiup/bin/tiup
===============================================
1. source /root/.bash_profile
2. Have a try: tiup playground
查看当前tiup 版本
[root@tidb30 soft]# tiup -v
1.11.3 tiup
Go Version: go1.19.5
Git Ref: v1.11.3
GitHash: 7223ed50460785a2adf666d511a257aa03110294
未执行
# source /home/tidb/.bash_profile
2.2.3. 合并 server 与 toolkit 镜像
# cd tidb-community-server-${version}-linux-amd64/
# cp -rp keys ~/.tiup/
# tiup mirror merge ../tidb-community-toolkit-${version}-linux-amd64
2.2.4. 查看离线镜像
# tiup mirror show
/soft/tidb-community-server-v6.5.1-linux-amd64
2.3. 升级检查
2.3.1. 确认或修改配置
执行升级操作前，需要检查官方的 TiDB 版本 release note，检查兼容性。根据实际配置项做相应修改。
~]$ tiup cluster edit-config demodb
tikv:
log-backup:
enable: true
注意：tikv配置log-backup 从v6.2.0开始引入。用于日志备份相关的配置项。本版本为v6.1.0可以忽略。
2.3.2. 检查集群
# tiup cluster check demodb --cluster
# mysql -P3307 -h192.168.169.31 -uroot -ptidb
mysql> ADMIN SHOW DDL
确保集群环境检查通过，并没有正在执行的 ddl 操作。
2.4. 停机升级
2.4.1. 停止集群
# tiup cluster stop tidb-test
2.4.2. 执行离线升级
# tiup cluster upgrade tidb-test v6.5.1 –offline
成功升级到v6.5.1，相关组件未启动。
启动并检查集群
# tiup cluster start tidb-test
# tiup cluster display tidb-test
2.5. 生态工具升级
在将 TiDB Server 与 TiDB ToolKit 工具包进行镜像合并后，首次执行 tiup 组件时，会自动检查版本并升级。
# tiup br
tiup is checking updates for component br ...
A new version of br is available:
The latest version: v6.5.1
Local installed version:
Update current component: tiup update br
Update all components: tiup update --all
The component `br` version is not installed; downloading from repository.
Starting component `br`: /root/.tiup/components/br/v6.5.1/br
br is a TiDB/TiKV cluster backup restore tool.
查看br版本
[root@tidb30 soft]# tiup br -V
tiup is checking updates for component br ...
Starting component `br`: /root/.tiup/components/br/v6.5.1/br -V
Release Version: v6.5.1
Git Commit Hash: 4084b077d615f9dc0a41cf2e30bc6e1a02332df2
Git Branch: heads/refs/tags/v6.5.1
Go Version: go1.19.5
UTC Build Time: 2023-03-07 16:04:15
Race Enabled: false
升级所有组件
# tiup update --all
将toolkit路径加入到系统变量PATH中；
export PATH=$PATH:/soft/tidb-community-toolkit-v6.5.1-linux-amd64