作者： 我是咖啡哥 原文来源： https://tidb.net/blog/9a7357ee

TiDB更新真的很快，像我这种喜欢尝鲜的DBA就喜欢用最新版本，新版本一出，立马就想跟上，公司环境一般都不能直接联网，所以特意总结了离线升级版本常用命令。

测试过的版本：v6.1.0-->v6.5.0，v6.5.0-->v7.1.0，v6.5.1-->v7.1.0

该命令版已经经过本人多次测试，用起来比较顺手，分享给需要的同学。

本文适合有一定经验的TiDB管理员使用。如果希望了解更详细的步骤请参考官方文档： https://docs.pingcap.com/zh/tidb/stable/upgrade-tidb-using-tiup

1、准备工作

下载软件

最新版软件下载地址，当前最新版本v7.1.0： https://cn.pingcap.com/product-community/

解压软件

--进入软件所在目录

cd /opt/soft/tar -zxvf tidb-community-server-${version}-linux-amd64.tar.gz
tar -zxvf tidb-community-toolkit-${version}-linux-amd64.tar.gz

定义两个变量，存目标版本和集群名称

version=v7.1.0
cluster_name=tidb-test

查看当前集群状态

tiup cluster display ${cluster_name}

2、更新 TiUP 离线镜像

执行local_install.sh脚本

sh tidb-community-server-${version}-linux-amd64/local_install.sh
tiup -v

将 server 和 toolkit 两个离线镜像合并

ls -ld tidb-community-server-${version}-linux-amd64 tidb-community-toolkit-${version}-linux-amd64
cd tidb-community-server-${version}-linux-amd64/
cp -rp keys ~/.tiup/
tiup mirror merge ../tidb-community-toolkit-${version}-linux-amd64

3、升级 Cluster 组件

tiup update cluster
tiup -v

若报错，尝试执行以下命令后继续。

rm -rf ~/.tiup/manifests/*

4、升级前环境检查

编辑参数文件，去除新版本不兼容参数

tiup cluster edit-config ${cluster_name}

检查DDL 和 Backup 情况

ADMIN SHOW DDL;

如果存在正在运行的ddl，请取消或者执行完成再升级。

ADMIN CANCEL DDL

查看备份情况，该命令只能查看通过backup或restores命令来备份恢复的会话，并且只能查看当前tidb server执行的会话！

SHOW BACKUPS;
SHOW RESTORES;

查看使用br命令的会话：

ps -ef|grep br

5、升级集群到指定版本

-- 在线升级

tiup cluster upgrade ${cluster_name} ${version}

-- or 离线升级

tiup cluster upgrade ${cluster_name} ${version} --offline

6、升级后验证集群状态

tiup cluster display ${cluster_name}

7、升级 FAQ

查看操作记录

tiup cluster audit

重试对应操作

tiup cluster replay <audit-id>

强制升级

升级时会跳过 PD transfer leader 和 TiKV evict leader 过程

tiup cluster upgrade ${cluster_name} ${version} --force

更新 pd-ctl 等周边工具版本

tiup install ctl:${version}