From a19b956b457f3dd78cf6c2eaf560e84046a9bf97 Mon Sep 17 00:00:00 2001 From: Aolin Date: Fri, 29 Dec 2023 10:36:28 +0800 Subject: [PATCH] upgrade TiDB: check DDL and backup status before checking cluster health (#15936) --- upgrade-tidb-using-tiup.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index 21bacb13d958..4d0a3b724f00 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -141,7 +141,14 @@ tiup update cluster > > 升级到 v7.5.0 版本前，请确认已在 4.0 修改的参数在 v7.5.0 版本中是兼容的，可参考 [TiKV 配置文件描述](/tikv-configuration-file.md)。 -### 2.4 检查当前集群的健康状况 +### 2.4 检查当前集群的 DDL 和 Backup 情况 + +为避免升级过程中出现未定义行为或其他故障，建议检查以下指标后再进行升级操作。 + +- 集群 DDL 情况：建议使用 [`ADMIN SHOW DDL`](/sql-statements/sql-statement-admin-show-ddl.md) 命令查看集群中是否有正在进行的 DDL Job。如需升级，请等待 DDL 执行完成或使用 [`ADMIN CANCEL DDL`](/sql-statements/sql-statement-admin-cancel-ddl.md) 命令取消该 DDL Job 后再进行升级。 +- 集群 Backup 情况：建议使用 [`SHOW [BACKUPS|RESTORES]`](/sql-statements/sql-statement-show-backups.md) 命令查看集群中是否有正在进行的 Backup 或者 Restore 任务。如需升级，请等待 Backup 执行完成后，得到一个有效的备份后再执行升级。 + +### 2.5 检查当前集群的健康状况 为避免升级过程中出现未定义行为或其他故障，建议在升级前对集群当前的 region 健康状态进行检查，此操作可通过 `check` 子命令完成。 @@ -153,13 +160,6 @@ tiup cluster check --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`](/sql-statements/sql-statement-admin-show-ddl.md) 命令查看集群中是否有正在进行的 DDL Job。如需升级，请等待 DDL 执行完成或使用 [`ADMIN CANCEL DDL`](/sql-statements/sql-statement-admin-cancel-ddl.md) 命令取消该 DDL Job 后再进行升级。 -- 集群 Backup 情况：建议使用 [`SHOW [BACKUPS|RESTORES]`](/sql-statements/sql-statement-show-backups.md) 命令查看集群中是否有正在进行的 Backup 或者 Restore 任务。如需升级，请等待 Backup 执行完成后，得到一个有效的备份后再执行升级。 - ## 3. 升级 TiDB 集群 本部分介绍如何滚动升级 TiDB 集群以及如何进行升级后的验证。