[转帖]使用 TiUP 升级 TiDB

您淘淘网 2024-01-11 01:08:15 ©著作权

文章标签 离线 linux 文章分类 Python 热度指数 0

©著作权归作者所有：来自知识热度网作者您淘淘网的原创作品，请联系作者获取转载授权，否则将追究法律责任

本文档适用于以下升级路径：

使用 TiUP 从 TiDB 4.0 版本升级至 TiDB 7.1。
使用 TiUP 从 TiDB 5.0-5.4 版本升级至 TiDB 7.1。
使用 TiUP 从 TiDB 6.0-6.6 版本升级至 TiDB 7.1。
使用 TiUP 从 TiDB 7.0 版本升级至 TiDB 7.1。

警告

不支持将 TiFlash 组件从 5.3 之前的老版本在线升级至 5.3 及之后的版本，只能采用停机升级。如果集群中其他组件（如 tidb，tikv）不能停机升级，参考不停机升级中的注意事项。
在升级 TiDB 集群的过程中，请勿执行DDL 语句，否则可能会出现行为未定义的问题。
集群中有 DDL 语句正在被执行时（通常为ADD INDEX和列类型变更等耗时较久的 DDL 语句），请勿进行升级操作。在升级前，建议使用ADMIN SHOW DDL命令查看集群中是否有正在进行的 DDL Job。如需升级，请等待 DDL 执行完成或使用ADMIN CANCEL DDL命令取消该 DDL Job 后再进行升级。

从 TiDB v7.1 版本升级至更高的版本时，可以不遵循上面的限制 2 和 3，建议参考平滑升级 TiDB 的限制。

注意

如果原集群是 3.0 或 3.1 或更早的版本，不支持直接升级到 v7.1.0 及后续修订版本。你需要先从早期版本升级到 4.0 后，再从 4.0 升级到 v7.1.0 及后续修订版本。

`1. 升级兼容性说明`

TiDB 目前暂不支持版本降级或升级后回退。
使用 TiDB Ansible 管理的 4.0 版本集群，需要先按照4.0 版本文档的说明将集群导入到 TiUP (tiup cluster) 管理后，再按本文档说明升级到 v7.1.1 版本。
若要将 v3.0 之前的版本升级至 v7.1.1 版本：

首先通过 TiDB Ansible 升级到 3.0 版本。
然后按照4.0 版本文档的说明，使用 TiUP (tiup cluster) 将 TiDB Ansible 配置导入。
将集群升级至 v4.0 版本。
按本文档说明将集群升级到 v7.1.1 版本。

支持 TiDB Binlog，TiCDC，TiFlash 等组件版本的升级。
将 v6.3.0 之前的 TiFlash 升级至 v6.3.0 及之后的版本时，需要特别注意：在 Linux AMD64 架构的硬件平台部署 TiFlash 时，CPU 必须支持 AVX2 指令集。而在 Linux ARM64 架构的硬件平台部署 TiFlash 时，CPU 必须支持 ARMv8 架构。具体请参考6.3.0 版本 Release Notes中的描述。
具体不同版本的兼容性说明，请查看各个版本的Release Note。请根据各个版本的 Release Note 的兼容性更改调整集群的配置。
升级 v5.3 之前版本的集群到 v5.3 及后续版本时，默认部署的 Prometheus 会从 v2.8.1 升级到 v2.27.1，v2.27.1 提供更多的功能并解决了安全风险。Prometheus v2.27.1 相对于 v2.8.1 存在 Alert 时间格式变化，详情见Prometheus commit。

`2. 升级前准备`

本部分介绍实际开始升级前需要进行的更新 TiUP 和 TiUP Cluster 组件版本等准备工作。

`2.1 查阅兼容性变更`

查阅 TiDB release notes 中的兼容性变更。如果有任何变更影响到了你的升级，请采取相应的措施。

以下为从 v7.0.0 升级至当前版本 (v7.1.1) 所需兼容性变更信息。如果从 v6.6.0 或之前版本升级到当前版本，可能也需要考虑和查看中间版本release notes中提到的兼容性变更信息。

TiDB v7.1.0 release notes 中的兼容性变更
TiDB v7.1.1 release notes 中的兼容性变更

`2.2 升级 TiUP 或更新 TiUP 离线镜像`

`升级 TiUP 和 TiUP Cluster`

注意

如果原集群中控机不能访问https://tiup-mirrors.pingcap.com地址，可跳过本步骤，然后更新 TiUP 离线镜像。

先升级 TiUP 版本（建议tiup版本不低于1.11.3）：tiup update --self tiup --version
再升级 TiUP Cluster 版本（建议tiup cluster版本不低于1.11.3）：tiup update cluster tiup cluster --version

`更新 TiUP 离线镜像`

注意

如果原集群不是通过离线部署方式部署的，可忽略此步骤。

可以参考使用 TiUP 部署 TiDB 集群的步骤下载部署新版本的 TiUP 离线镜像，上传到中控机。在执行local_install.sh后，TiUP 会完成覆盖升级。

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

小贴士

关于TiDB-community-server软件包和TiDB-community-toolkit软件包的内容物，请查阅TiDB 离线包。

覆盖升级完成后，需将 server 和 toolkit 两个离线镜像合并，执行以下命令合并离线组件到 server 目录下。

tar xf tidb-community-toolkit-${version}-linux-amd64.tar.gz 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

离线镜像合并后，执行下列命令升级 Cluster 组件：

tiup update cluster

此时离线镜像已经更新成功。如果覆盖后发现 TiUP 运行报错，可能是 manifest 未更新导致，可尝试rm -rf ~/.tiup/manifests/*后再使用。

`2.3 编辑 TiUP Cluster 拓扑配置文件`

注意

以下情况可跳过此步骤：

原集群没有修改过配置参数，或通过 tiup cluster 修改过参数但不需要调整。
升级后对未修改过的配置项希望使用 v7.1.1 默认参数。

进入拓扑文件的vi编辑模式：tiup cluster edit-config <cluster-name>
参考topology配置模板的格式，将希望修改的参数填到拓扑文件的server_configs下面。

修改完成后:wq保存并退出编辑模式，输入Y确认变更。

注意

升级到 v7.1.1 版本前，请确认已在 4.0 修改的参数在 v7.1.1 版本中是兼容的，可参考TiKV 配置文件描述。

`2.4 检查当前集群的健康状况`

为避免升级过程中出现未定义行为或其他故障，建议在升级前对集群当前的 region 健康状态进行检查，此操作可通过check子命令完成。

tiup cluster check <cluster-name> --cluster

执行结束后，最后会输出 region status 检查结果。如果结果为 "All regions are healthy"，则说明当前集群中所有 region 均为健康状态，可以继续执行升级；如果结果为 "Regions are not fully healthy: m miss-peer, n pending-peer" 并提示 "Please fix unhealthy regions before other operations."，则说明当前集群中有 region 处在异常状态，应先排除相应异常状态，并再次检查结果为 "All regions are healthy" 后再继续升级。

`2.5 检查当前集群的 DDL 和 Backup 情况`

为避免升级过程中出现未定义行为或其他故障，建议检查以下指标后再进行升级操作。

集群 DDL 情况：建议使用ADMIN SHOW DDL命令查看集群中是否有正在进行的 DDL Job。如需升级，请等待 DDL 执行完成或使用ADMIN CANCEL DDL命令取消该 DDL Job 后再进行升级。
集群 Backup 情况：建议使用SHOW [BACKUPS|RESTORES]命令查看集群中是否有正在进行的 Backup 或者 Restore 任务。如需升级，请等待 Backup 执行完成后，得到一个有效的备份后再执行升级。

`3. 升级 TiDB 集群`

本部分介绍如何滚动升级 TiDB 集群以及如何进行升级后的验证。

`3.1 将集群升级到指定版本`

升级的方式有两种：不停机升级和停机升级。TiUP Cluster 默认的升级 TiDB 集群的方式是不停机升级，即升级过程中集群仍然可以对外提供服务。升级时会对各节点逐个迁移 leader 后再升级和重启，因此对于大规模集群需要较长时间才能完成整个升级操作。如果业务有维护窗口可供数据库停机维护，则可以使用停机升级的方式快速进行升级操作。

`不停机升级`

tiup cluster upgrade <cluster-name> <version>

以升级到 v7.1.1 版本为例：

tiup cluster upgrade <cluster-name> v7.1.1

注意

滚动升级会逐个升级所有的组件。升级 TiKV 期间，会逐个将 TiKV 上的所有 leader 切走再停止该 TiKV 实例。默认超时时间为 5 分钟（300 秒），超时后会直接停止该实例。
使用--force参数可以在不驱逐 leader 的前提下快速升级集群至新版本，但是该方式会忽略所有升级中的错误，在升级失败后得不到有效提示，请谨慎使用。
如果希望保持性能稳定，则需要保证 TiKV 上的所有 leader 驱逐完成后再停止该 TiKV 实例，可以指定--transfer-timeout为一个更大的值，如--transfer-timeout 3600，单位为秒。
若想将 TiFlash 从 5.3 之前的版本升级到 5.3 及之后的版本，必须进行 TiFlash 的停机升级。参考如下步骤，可以在确保其他组件正常运行的情况下升级 TiFlash：

关闭 TiFlash 实例：tiup cluster stop <cluster-name> -R tiflash
使用--offline参数在不重启（只更新文件）的情况下升级集群：tiup cluster upgrade <cluster-name> <version> --offline，例如tiup cluster upgrade <cluster-name> v6.3.0 --offline
reload 整个集群：tiup cluster reload <cluster-name>。此时，TiFlash 也会正常启动，无需额外操作。

在对使用 TiDB Binlog 的集群进行滚动升级过程中，请避免新创建聚簇索引表。

`停机升级`

在停机升级前，首先需要将整个集群关停。

tiup cluster stop <cluster-name>

之后通过upgrade命令添加--offline参数来进行停机升级，其中<cluster-name>为集群名，<version>为升级的目标版本，例如v7.1.1。

tiup cluster upgrade <cluster-name> <version> --offline

升级完成后集群不会自动启动，需要使用start命令来启动集群。

tiup cluster start <cluster-name>

`3.2 升级后验证`

执行display命令来查看最新的集群版本TiDB Version：

tiup cluster display <cluster-name>

Cluster type: tidb Cluster name: <cluster-name> Cluster version: v7.1.1

`4. 升级 FAQ`

本部分介绍使用 TiUP 升级 TiDB 集群遇到的常见问题。

`4.1 升级时报错中断，处理完报错后，如何继续升级`

重新执行tiup cluster upgrade命令进行升级，升级操作会重启之前已经升级完成的节点。如果不希望重启已经升级过的节点，可以使用replay子命令来重试操作，具体方法如下：

使用tiup cluster audit命令查看操作记录：tiup cluster audit在其中找到失败的升级操作记录，并记下该操作记录的 ID，下一步中将使用<audit-id>表示操作记录 ID 的值。
使用tiup cluster replay <audit-id>命令重试对应操作：tiup cluster replay <audit-id>

`4.2 升级过程中 evict leader 等待时间过长，如何跳过该步骤快速升级`

可以指定--force，升级时会跳过PD transfer leader和TiKV evict leader过程，直接重启并升级版本，对线上运行的集群性能影响较大。命令如下，其中<version>为升级的目标版本，例如v7.1.1：

tiup cluster upgrade <cluster-name> <version> --force

`4.3 升级完成后，如何更新 pd-ctl 等周边工具版本`

可通过 TiUP 安装对应版本的ctl组件来更新相关工具版本：

tiup install ctl:v7.1.1


    
        
                        
                
                    
                    赞
                
            



                
                    
                    分享
                
            
           
            微博QQ微信
            


           
              
              
             打赏
            
          

                     
                    
                        
                        举报
                    
                
            
                
                    
                    踩
                
            
          
    
    
                    上一篇：[转帖]金仓数据库KingbaseES误删除系统超级用户（superuser）权限的恢复方式
                    下一篇：[转帖]vdbench




 

 



    
        
            相关文章
        
        

                            
                    
                        
                            皮克斯2 CTO：VISION PRO 的未来和 USD WEB TOOLS
                             我们采访了皮克斯 CTO Steve May，了解了 USD 的最新发展。USD 是一种开放的 3D 内容标准，正在被 Apple、Meta、Nvidia 等公司使用。

译自 Pixar CTO on OpenUSD, Vision Pro
                        
                        
                                                    
                                                                    
                                         ico                                    
                                                                    
                                         Elastic                                    
                                                                    
                                         docker                                    
                                                            
                                                                    

                
                            
                    
                        
                            云计算 - 对象存储服务OSS技术全解3
                             云计算概述

云计算是一种通过网络连接的方式，以服务的形式提供计算资源和存储空间的技术。它能够帮助用户通过互联网使用计算资源，无需购买和维护实际的物理设备。云计算通过
                        
                        
                                                    
                                                                    
                                         ico                                    
                                                                    
                                         Elastic                                    
                                                                    
                                         docker                                    
                                                            
                                                                    

                
                            
                    
                        
                            云计算 - 弹性计算技术全解与实践
                             第一章弹性计算技术概述
弹性计算技术定义
弹性计算技术是一种基于云计算的技术，它旨在实现根据用户需求进行资源的自动调配和弹性扩展。本章将对弹性计算技术进行详细概述。
                        
                        
                                                    
                                                                    
                                         ico                                    
                                                                    
                                         Elastic                                    
                                                                    
                                         docker                                    
                                                            
                                                                    

                
                            
                    
                        
                            深入探索Docker容器启动脚本：解析、优化与调试
                             Docker是一种开源的应用容器引擎，它允许开发者将应用及其依赖打包到一个可移植的容器中，然后发布到任何流行的Linux机器或Windows机器上，也可以实现虚拟化。容器是完全使用沙箱
                        
                        
                                                    
                                                                    
                                         ico                                    
                                                                    
                                         Elastic                                    
                                                                    
                                         docker                                    
                                                            
                                                                    

                
                            
                    
                        
                            临沂城建“做媒”，中国女排与沂蒙大地“双向奔赴”
                             临沂城建“做媒”，中国女排与沂蒙大地“双向奔赴”，来源：体育行业网2023年10月7日，杭州亚运会上，中国女排3比0战胜日本女排夺得冠军，第九次站在亚运会最高领奖台。摧枯拉朽般的胜利，值得所有人的掌声和欢呼，这其中来自沂蒙老区人民的呐喊尤为响亮。同年12月25日下午，国家体育总局排球运动管理中心副主任袁磊宣布，2024年排球超级联赛全明星系列活动将于1月12日-14日在山东临沂奥体公园体育馆举办，李盈盈、王云蕗、仲慧、吴梦洁、袁心玥、王媛媛、高意
                        
                        
                                                    
                                                                    
                                         ico                                    
                                                                    
                                         Elastic                                    
                                                                    
                                         docker                                    
                                                            
                                                                    

                
                            
                    
                        
                            数字化转型浪潮中的挑战与机遇：企业如何应对七大难点_光点科技
                             数字化转型浪潮中的挑战与机遇：企业如何应对七大难点_光点科技，随着技术的日益进步，企业数字化转型已成为推动商业模式创新和运营优化的关键。尽管数字化转型提供了无限的可能性，但过程中的难点同样不容小觑。下面，我们将逐一剖析企业转型中的七大难点，并提供相应的应对策略。
                        
                        
                                                    
                                                                    
                                         ico                                    
                                                                    
                                         Elastic                                    
                                                                    
                                         docker                                    
                                                            
                                                                    

                
                            
                    
                        
                            HBase表的读写性能低下
                             HBase表的读写性能低下，假设我们面临的问题是HBase集群中某个表的读写性能较差，影响了业务的实时查询和数据写入。我们通过以下实际案例来解决这个问题：问题：HBase表的读写性能低下实战解决：案例：我们的HBase表设计采用了默认的随机RowKey，导致数据写入时可能引发热点问题。同时，表结构设计上没有很好地利用列簇。这导致了RegionServer之间负载不均衡，以及磁盘写入性能下降。实施步骤：表设计优化：重新设计R
                        
                        
                                                    
                                                                    
                                         ico                                    
                                                                    
                                         Elastic                                    
                                                                    
                                         docker                                    
                                                            
                                                                    

                
                            
                    
                        
                            HDFS原理详解与实例解析
                             HDFS原理详解与实例解析，HDFS原理详解与实例解析1.HDFS架构设计1.1NameNode与DataNodeHDFS采用主从架构，其中一个NameNode负责管理文件系统的命名空间，而多个DataNode负责实际数据的存储。这一设计使得系统能够有效管理和存储庞大的数据集。实例：NameNode和DataNode的角色类比于一家公司，NameNode就像公司的总部，负责制定规章制度和管理公司的整体运作；而DataNo
                        
                        
                                                    
                                                                    
                                         ico                                    
                                                                    
                                         Elastic                                    
                                                                    
                                         docker                                    
                                                            
                                                                    

                
                            
                    
                        
                            解决HDFS技术问题的案例：数据丢失与恢复
                             解决HDFS技术问题的案例：数据丢失与恢复，摘要：本案例研究描述了一个实际的情景，展示了如何解决HDFS技术问题中的数据丢失和恢复。案例中涉及到一个HDFS集群，在一次节点故障后，部分数据丢失。通过仔细的问题分析、检查手段和代码示例，我们成功恢复了丢失的数据。背景：我们的HDFS集群由10个数据节点组成，用于存储和处理大规模数据集。每个数据节点上都运行着Hadoop进程，负责存储数据和维护数据副本。我们的集群遇到了一个问题，其中一个数据节
                        
                        
                                                    
                                                                    
                                         ico                                    
                                                                    
                                         Elastic                                    
                                                                    
                                         docker                                    
                                                            
                                                                    

                
                            
                    
                        
                            首次邂逅，全城瞩目！临沂奥体发出排超全明星“邀请函”
                             首次邂逅，全城瞩目！临沂奥体发出排超全明星“邀请函”，来源：中国体育周刊2023-2024排球超级联赛全明星周末来临在即,这也是排球超级联赛首次把全明星周末放在北方城市举办,首度邂逅,全城瞩目。从山东儒辰男排主场正式落户临沂那天起,临沂奥体公园就已开始为排超全明星赛事积极准备,如今排超全明星周末在临举办,全民期待的同时,亦是众望所归,而即将迎来体育盛事的临沂奥体公园,也早已做足准备!“好戏”轮番登台,场馆提档升级1月8日,记者来到临沂市奥体公园体育馆
                        
                        
                                                    
                                                                    
                                         ico                                    
                                                                    
                                         Elastic                                    
                                                                    
                                         docker

深度学习	数据分析	神经网络	机器学习
负载均衡	数据仓库	帝国CMS	网站运维

网络安全	考试认证	织梦CMS	海洋CMS
办公效率	代码人生	苹果CMS	电商服务

知识热度网

[转帖]使用 TiUP 升级 TiDB

`1. 升级兼容性说明`

`2. 升级前准备`

`2.1 查阅兼容性变更`

`2.2 升级 TiUP 或更新 TiUP 离线镜像`

`升级 TiUP 和 TiUP Cluster`

`更新 TiUP 离线镜像`

`2.3 编辑 TiUP Cluster 拓扑配置文件`

`2.4 检查当前集群的健康状况`

`2.5 检查当前集群的 DDL 和 Backup 情况`

`3. 升级 TiDB 集群`

`3.1 将集群升级到指定版本`

`不停机升级`

`停机升级`

`3.2 升级后验证`

`4. 升级 FAQ`

`4.1 升级时报错中断，处理完报错后，如何继续升级`

`4.2 升级过程中 evict leader 等待时间过长，如何跳过该步骤快速升级`

`4.3 升级完成后，如何更新 pd-ctl 等周边工具版本`

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

微信扫一扫打赏