From b70ca2e30ae3afe28ee8e998f8e204d68d56976b Mon Sep 17 00:00:00 2001 From: Benjamin2037 Date: Mon, 31 Jul 2023 14:16:00 +0800 Subject: [PATCH 1/4] Add note for how to use server node during TiDB cluster upgrade. --- tidb-configuration-file.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/tidb-configuration-file.md b/tidb-configuration-file.md index f4f45214b983..a4fe1a961680 100644 --- a/tidb-configuration-file.md +++ b/tidb-configuration-file.md @@ -122,6 +122,9 @@ TiDB 配置文件比命令行参数支持更多的选项。你可以在 [config/ + 默认值："" + 默认情况下，TiDB 版本号格式为：`5.7.${mysql_latest_minor_version}-TiDB-${tidb_version}`。 +> **注意：** +> server-version 会被用于 TiDB 节点来验证当前 TiDB 的版本，因此在进行 TiDB 集群升级前，请将 server-version 清理掉，或者设置为当前 TiDB 真实的版本值，避免出现非预期行为。 + ### `repair-mode` + 用于开启非可信修复模式，启动该模式后，可以过滤 `repair-table-list` 名单中坏表的加载。 From a1c4b3ea79bac6b62e481520bb65ee117e893276 Mon Sep 17 00:00:00 2001 From: Benjamin2037 Date: Mon, 31 Jul 2023 17:36:27 +0800 Subject: [PATCH 2/4] Add server-version note on tiup upgrade description. --- upgrade-tidb-using-tiup.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index b493d6a82f55..d4646e1d65fb 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -21,7 +21,8 @@ title: 使用 TiUP 升级 TiDB > **注意：** > -> 如果原集群是 3.0 或 3.1 或更早的版本，不支持直接升级到 v7.2.0 及后续修订版本。你需要先从早期版本升级到 4.0 后，再从 4.0 升级到 v7.2.0 及后续修订版本。 +> 如果原集群是 3.0 或 3.1 或更早的版本，不支持直接升级到 v7.2.0 及后续修订版本。你需要先从早期版本升级到 4.0 后，再从 4.0 升级到 v7.2.0 及后续修订版本。 +> 配置参数 ['server-version'](/tidb-configuration-file.md#server-version) 会被用于 TiDB 节点来验证当前 TiDB 的版本，因此在进行 TiDB 集群升级前，请将 server-version 清理掉，或者设置为当前 TiDB 真实的版本值，避免出现非预期行为。 ## 1. 升级兼容性说明 From d19865f8493f5af12c77cc8bb2a2a81d900191aa Mon Sep 17 00:00:00 2001 From: Ran Date: Wed, 2 Aug 2023 11:44:50 +0800 Subject: [PATCH 3/4] Apply suggestions from code review --- tidb-configuration-file.md | 3 ++- upgrade-tidb-using-tiup.md | 2 +- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/tidb-configuration-file.md b/tidb-configuration-file.md index a4fe1a961680..6f898694a95f 100644 --- a/tidb-configuration-file.md +++ b/tidb-configuration-file.md @@ -123,7 +123,8 @@ TiDB 配置文件比命令行参数支持更多的选项。你可以在 [config/ + 默认情况下，TiDB 版本号格式为：`5.7.${mysql_latest_minor_version}-TiDB-${tidb_version}`。 > **注意：** -> server-version 会被用于 TiDB 节点来验证当前 TiDB 的版本，因此在进行 TiDB 集群升级前，请将 server-version 清理掉，或者设置为当前 TiDB 真实的版本值，避免出现非预期行为。 +> +> `server-version` 的值会被 TiDB 节点用于验证当前 TiDB 的版本。因此在进行 TiDB 集群升级前，请将 `server-version` 的值设置为空或者当前 TiDB 真实的版本值，避免出现非预期行为。 ### `repair-mode` diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index d4646e1d65fb..f42139022121 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -22,7 +22,7 @@ title: 使用 TiUP 升级 TiDB > **注意：** > > 如果原集群是 3.0 或 3.1 或更早的版本，不支持直接升级到 v7.2.0 及后续修订版本。你需要先从早期版本升级到 4.0 后，再从 4.0 升级到 v7.2.0 及后续修订版本。 -> 配置参数 ['server-version'](/tidb-configuration-file.md#server-version) 会被用于 TiDB 节点来验证当前 TiDB 的版本，因此在进行 TiDB 集群升级前，请将 server-version 清理掉，或者设置为当前 TiDB 真实的版本值，避免出现非预期行为。 +> 配置参数 [`server-version`](/tidb-configuration-file.md#server-version) 的值会被 TiDB 节点用于验证当前 TiDB 的版本。因此在进行 TiDB 集群升级前，请将 `server-version` 的值设置为空或者当前 TiDB 真实的版本值，避免出现非预期行为。 ## 1. 升级兼容性说明 From 596f48d7072471d14ff9a90e05369b2196a85292 Mon Sep 17 00:00:00 2001 From: Ran Date: Wed, 2 Aug 2023 12:38:30 +0800 Subject: [PATCH 4/4] Update upgrade-tidb-using-tiup.md --- upgrade-tidb-using-tiup.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index f42139022121..b64c2338a491 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -21,8 +21,8 @@ title: 使用 TiUP 升级 TiDB > **注意：** > -> 如果原集群是 3.0 或 3.1 或更早的版本，不支持直接升级到 v7.2.0 及后续修订版本。你需要先从早期版本升级到 4.0 后，再从 4.0 升级到 v7.2.0 及后续修订版本。 -> 配置参数 [`server-version`](/tidb-configuration-file.md#server-version) 的值会被 TiDB 节点用于验证当前 TiDB 的版本。因此在进行 TiDB 集群升级前，请将 `server-version` 的值设置为空或者当前 TiDB 真实的版本值，避免出现非预期行为。 +> - 如果原集群是 3.0 或 3.1 或更早的版本，不支持直接升级到 v7.2.0 及后续修订版本。你需要先从早期版本升级到 4.0 后，再从 4.0 升级到 v7.2.0 及后续修订版本。 +> - 配置参数 [`server-version`](/tidb-configuration-file.md#server-version) 的值会被 TiDB 节点用于验证当前 TiDB 的版本。因此在进行 TiDB 集群升级前，请将 `server-version` 的值设置为空或者当前 TiDB 真实的版本值，避免出现非预期行为。 ## 1. 升级兼容性说明