From fcb7d1610e71bf0d439619dcde573e00ac75b9bc Mon Sep 17 00:00:00 2001 From: Roger Song Date: Wed, 6 Mar 2024 22:00:21 +0800 Subject: [PATCH 01/14] include description about extending timeout --- upgrade-tidb-using-tiup.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index 1f868e796065..6293636df09f 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -25,6 +25,21 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u > - 如果原集群是 3.0 或 3.1 或更早的版本，不支持直接升级到 v7.6.0 及后续修订版本。你需要先从早期版本升级到 4.0 后，再从 4.0 升级到 v7.6.0 及后续修订版本。 > - 如果原集群是 6.2 之前的版本，升级到 6.2 及以上版本时，部分场景会遇到升级卡住的情况，你可以参考[如何解决升级卡住的问题](#42-升级到-v620-及以上版本时如何解决升级卡住的问题)。 > - 配置参数 [`server-version`](/tidb-configuration-file.md#server-version) 的值会被 TiDB 节点用于验证当前 TiDB 的版本。因此在进行 TiDB 集群升级前，请将 `server-version` 的值设置为空或者当前 TiDB 真实的版本值，避免出现非预期行为。 +> - 如果原集群为 v7.1.0 及更高版本，配置项 [`performance.force-init-stats`](/tidb-configuration-file.md#force-init-stats-从-v657-和-v710-版本开始引入) 设置为 `ON` 会延长 TiDB 的启动时间，这可能会造成启动超时，升级失败。建议为 TiUP 设置更长的等待时间 +> * 查看配置项 `force-init-stats` 的值。 +> ``` +> SHOW CONFIG WHERE type = 'tidb' AND name = 'performance.force-init-stats'; +> ``` +> * 通过增加命令行选项 [`--wait-timeout`](/tiup/tiup-component-cluster#wait-timeoutuint默认-120) 延长超时等待。如下将等待时间设置成 20 分钟 +> ```shell +> tiup update cluster --wait-timeout 1200 [other options] +> ``` +> 通常情况下，20分钟超时能满足绝大部分场景的等待。如果想要做更准确的预估，可以在 TiDB 日志中搜索 `init stats info time` 关键字，获取上次启动的加载时间作为参考。 例如： +> ``` +> [domain.go:2271] ["init stats info time"] [lite=true] ["take time"=2.151333ms] +> ``` +> * 如果想要加快 TiDB 滚动升级的时间，并且在升级过程中能够承受初始统计信息缺失带来的潜在性能影响。可以在升级前[用 TiUP 修改配置](/maintain-tidb-using-tiup.md#修改配置参数)，将 `performance.force-init-stats` 设置为 `OFF`。 升级完成后可酌情改回。 + ## 1. 升级兼容性说明 From b9ab041c8aa11281f1ef55bc79b7ab9547d0cd09 Mon Sep 17 00:00:00 2001 From: Roger Song Date: Wed, 6 Mar 2024 22:42:04 +0800 Subject: [PATCH 02/14] correct the version --- upgrade-tidb-using-tiup.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index 6293636df09f..16df934360d2 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -25,7 +25,10 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u > - 如果原集群是 3.0 或 3.1 或更早的版本，不支持直接升级到 v7.6.0 及后续修订版本。你需要先从早期版本升级到 4.0 后，再从 4.0 升级到 v7.6.0 及后续修订版本。 > - 如果原集群是 6.2 之前的版本，升级到 6.2 及以上版本时，部分场景会遇到升级卡住的情况，你可以参考[如何解决升级卡住的问题](#42-升级到-v620-及以上版本时如何解决升级卡住的问题)。 > - 配置参数 [`server-version`](/tidb-configuration-file.md#server-version) 的值会被 TiDB 节点用于验证当前 TiDB 的版本。因此在进行 TiDB 集群升级前，请将 `server-version` 的值设置为空或者当前 TiDB 真实的版本值，避免出现非预期行为。 -> - 如果原集群为 v7.1.0 及更高版本，配置项 [`performance.force-init-stats`](/tidb-configuration-file.md#force-init-stats-从-v657-和-v710-版本开始引入) 设置为 `ON` 会延长 TiDB 的启动时间，这可能会造成启动超时，升级失败。建议为 TiUP 设置更长的等待时间 +> - 配置项 [`performance.force-init-stats`](/tidb-configuration-file.md#force-init-stats-从-v657-和-v710-版本开始引入) 设置为 `ON` 会延长 TiDB 的启动时间，这可能会造成启动超时，升级失败。建议为 TiUP 设置更长的等待时间。 +> * 可能影响的场景 +> * 原集群版本低于 v6.5.6, v7.1.0 ( 没有配置项 `performance.force-init-stats` )，目标版本为 v7.2.0 及更高。 +> * 原集群版本高于 v6.5.7, v7.1.0 ，且 配置项 `performance.force-init-stats` 设置为 `ON`。 > * 查看配置项 `force-init-stats` 的值。 > ``` > SHOW CONFIG WHERE type = 'tidb' AND name = 'performance.force-init-stats'; From 7be6f0e739d2c668dc85b943bfc631eb2003dc70 Mon Sep 17 00:00:00 2001 From: Roger Song Date: Wed, 6 Mar 2024 22:46:31 +0800 Subject: [PATCH 03/14] Update upgrade-tidb-using-tiup.md --- upgrade-tidb-using-tiup.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index 16df934360d2..6f1bdc9e22af 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -28,8 +28,8 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u > - 配置项 [`performance.force-init-stats`](/tidb-configuration-file.md#force-init-stats-从-v657-和-v710-版本开始引入) 设置为 `ON` 会延长 TiDB 的启动时间，这可能会造成启动超时，升级失败。建议为 TiUP 设置更长的等待时间。 > * 可能影响的场景 > * 原集群版本低于 v6.5.6, v7.1.0 ( 没有配置项 `performance.force-init-stats` )，目标版本为 v7.2.0 及更高。 -> * 原集群版本高于 v6.5.7, v7.1.0 ，且 配置项 `performance.force-init-stats` 设置为 `ON`。 -> * 查看配置项 `force-init-stats` 的值。 +> * 原集群版本高于 v6.5.7, v7.1.0 ，且配置项 `performance.force-init-stats` 被设置为 `ON`。 +> * 查看配置项 `performance.force-init-stats` 的值。 > ``` > SHOW CONFIG WHERE type = 'tidb' AND name = 'performance.force-init-stats'; > ``` @@ -41,7 +41,7 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u > ``` > [domain.go:2271] ["init stats info time"] [lite=true] ["take time"=2.151333ms] > ``` -> * 如果想要加快 TiDB 滚动升级的时间，并且在升级过程中能够承受初始统计信息缺失带来的潜在性能影响。可以在升级前[用 TiUP 修改配置](/maintain-tidb-using-tiup.md#修改配置参数)，将 `performance.force-init-stats` 设置为 `OFF`。 升级完成后可酌情改回。 +> * 如果想要加快 TiDB 滚动升级的时间，并且在升级过程中能够承受初始统计信息缺失带来的潜在性能影响。可以在升级前[用 TiUP 修改目标实例的配置](/maintain-tidb-using-tiup.md#修改配置参数)，将 `performance.force-init-stats` 设置为 `OFF`。 升级完成后可酌情改回。 ## 1. 升级兼容性说明 From 954279585fe3ea9b0adc8c450516ca865cab5f3e Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Thu, 7 Mar 2024 17:32:36 +0800 Subject: [PATCH 04/14] minor wording updates --- upgrade-tidb-using-tiup.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index 6f1bdc9e22af..9dc16c61f79a 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -25,23 +25,23 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u > - 如果原集群是 3.0 或 3.1 或更早的版本，不支持直接升级到 v7.6.0 及后续修订版本。你需要先从早期版本升级到 4.0 后，再从 4.0 升级到 v7.6.0 及后续修订版本。 > - 如果原集群是 6.2 之前的版本，升级到 6.2 及以上版本时，部分场景会遇到升级卡住的情况，你可以参考[如何解决升级卡住的问题](#42-升级到-v620-及以上版本时如何解决升级卡住的问题)。 > - 配置参数 [`server-version`](/tidb-configuration-file.md#server-version) 的值会被 TiDB 节点用于验证当前 TiDB 的版本。因此在进行 TiDB 集群升级前，请将 `server-version` 的值设置为空或者当前 TiDB 真实的版本值，避免出现非预期行为。 -> - 配置项 [`performance.force-init-stats`](/tidb-configuration-file.md#force-init-stats-从-v657-和-v710-版本开始引入) 设置为 `ON` 会延长 TiDB 的启动时间，这可能会造成启动超时，升级失败。建议为 TiUP 设置更长的等待时间。 -> * 可能影响的场景 +> - 配置项 [`performance.force-init-stats`](/tidb-configuration-file.md#force-init-stats-从-v657-和-v710-版本开始引入) 设置为 `ON` 会延长 TiDB 的启动时间，这可能会造成启动超时，升级失败。为避免这种情况，建议为 TiUP 设置更长的等待时间。 +> - 可能受影响的场景： > * 原集群版本低于 v6.5.6, v7.1.0 ( 没有配置项 `performance.force-init-stats` )，目标版本为 v7.2.0 及更高。 > * 原集群版本高于 v6.5.7, v7.1.0 ，且配置项 `performance.force-init-stats` 被设置为 `ON`。 -> * 查看配置项 `performance.force-init-stats` 的值。 +> * 查看配置项 `performance.force-init-stats` 的值： > ``` > SHOW CONFIG WHERE type = 'tidb' AND name = 'performance.force-init-stats'; > ``` -> * 通过增加命令行选项 [`--wait-timeout`](/tiup/tiup-component-cluster#wait-timeoutuint默认-120) 延长超时等待。如下将等待时间设置成 20 分钟 +> * 通过增加命令行选项 [`--wait-timeout`](/tiup/tiup-component-cluster.md#--wait-timeoutuint默认-120) 延长 TiUP 超时等待。如下命令可将超时等待设置成 1200 秒（即 20 分钟）。 > ```shell > tiup update cluster --wait-timeout 1200 [other options] > ``` -> 通常情况下，20分钟超时能满足绝大部分场景的等待。如果想要做更准确的预估，可以在 TiDB 日志中搜索 `init stats info time` 关键字，获取上次启动的加载时间作为参考。 例如： +> 通常情况下，20 分钟超时等待能满足绝大部分场景的需求。如果需要更准确的预估，可以在 TiDB 日志中搜索 `init stats info time` 关键字，获取上次启动的加载时间作为参考。 例如： > ``` > [domain.go:2271] ["init stats info time"] [lite=true] ["take time"=2.151333ms] > ``` -> * 如果想要加快 TiDB 滚动升级的时间，并且在升级过程中能够承受初始统计信息缺失带来的潜在性能影响。可以在升级前[用 TiUP 修改目标实例的配置](/maintain-tidb-using-tiup.md#修改配置参数)，将 `performance.force-init-stats` 设置为 `OFF`。 升级完成后可酌情改回。 +> * 如果想要缩短 TiDB 滚动升级的时间，并且在升级过程中能够承受初始统计信息缺失带来的潜在性能影响。可以在升级前[用 TiUP 修改目标实例的配置](/maintain-tidb-using-tiup.md#修改配置参数)，将 `performance.force-init-stats` 设置为 `OFF`。 升级完成后可酌情改回。 ## 1. 升级兼容性说明 From 2ba13e5b856c46d15ed8ce42f5ff5fdb9c4689df Mon Sep 17 00:00:00 2001 From: Roger Song Date: Fri, 8 Mar 2024 10:36:21 +0800 Subject: [PATCH 05/14] add one exception that we cannot anticipate the duration --- upgrade-tidb-using-tiup.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index 9dc16c61f79a..e23aa1f48342 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -27,8 +27,8 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u > - 配置参数 [`server-version`](/tidb-configuration-file.md#server-version) 的值会被 TiDB 节点用于验证当前 TiDB 的版本。因此在进行 TiDB 集群升级前，请将 `server-version` 的值设置为空或者当前 TiDB 真实的版本值，避免出现非预期行为。 > - 配置项 [`performance.force-init-stats`](/tidb-configuration-file.md#force-init-stats-从-v657-和-v710-版本开始引入) 设置为 `ON` 会延长 TiDB 的启动时间，这可能会造成启动超时，升级失败。为避免这种情况，建议为 TiUP 设置更长的等待时间。 > - 可能受影响的场景： -> * 原集群版本低于 v6.5.6, v7.1.0 ( 没有配置项 `performance.force-init-stats` )，目标版本为 v7.2.0 及更高。 -> * 原集群版本高于 v6.5.7, v7.1.0 ，且配置项 `performance.force-init-stats` 被设置为 `ON`。 +> * 原集群版本低于 v6.5.7, v7.1.0 ( 没有配置项 `performance.force-init-stats` )，目标版本为 v7.2.0 及更高。 +> * 原集群版本高于或等于 v6.5.7, v7.1.0 ，且配置项 `performance.force-init-stats` 被设置为 `ON`。 > * 查看配置项 `performance.force-init-stats` 的值： > ``` > SHOW CONFIG WHERE type = 'tidb' AND name = 'performance.force-init-stats'; @@ -41,6 +41,7 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u > ``` > [domain.go:2271] ["init stats info time"] [lite=true] ["take time"=2.151333ms] > ``` +> * 如果原数据库是 v7.1.0 或更低，升级到 v7.2.0 以上版本时，由于 [`performance.lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-从-v710-版本开始引入) 的引入，加载时间会大幅减少。这个情况下，用上述方法做的时间预估会偏长。 > * 如果想要缩短 TiDB 滚动升级的时间，并且在升级过程中能够承受初始统计信息缺失带来的潜在性能影响。可以在升级前[用 TiUP 修改目标实例的配置](/maintain-tidb-using-tiup.md#修改配置参数)，将 `performance.force-init-stats` 设置为 `OFF`。 升级完成后可酌情改回。 From d4473f40618539af0d43e476e9341240d9442f76 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Fri, 8 Mar 2024 11:50:00 +0800 Subject: [PATCH 06/14] Update upgrade-tidb-using-tiup.md --- upgrade-tidb-using-tiup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index e23aa1f48342..865379921dae 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -25,7 +25,7 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u > - 如果原集群是 3.0 或 3.1 或更早的版本，不支持直接升级到 v7.6.0 及后续修订版本。你需要先从早期版本升级到 4.0 后，再从 4.0 升级到 v7.6.0 及后续修订版本。 > - 如果原集群是 6.2 之前的版本，升级到 6.2 及以上版本时，部分场景会遇到升级卡住的情况，你可以参考[如何解决升级卡住的问题](#42-升级到-v620-及以上版本时如何解决升级卡住的问题)。 > - 配置参数 [`server-version`](/tidb-configuration-file.md#server-version) 的值会被 TiDB 节点用于验证当前 TiDB 的版本。因此在进行 TiDB 集群升级前，请将 `server-version` 的值设置为空或者当前 TiDB 真实的版本值，避免出现非预期行为。 -> - 配置项 [`performance.force-init-stats`](/tidb-configuration-file.md#force-init-stats-从-v657-和-v710-版本开始引入) 设置为 `ON` 会延长 TiDB 的启动时间，这可能会造成启动超时，升级失败。为避免这种情况，建议为 TiUP 设置更长的等待时间。 +> - 配置项 [`performance.force-init-stats`](/tidb-configuration-file.md#force-init-stats-从-v657-和-v710-版本开始引入) 设置为 `ON` 会延长 TiDB 的启动时间，这可能会造成启动超时，升级失败。为避免这种情况，建议为 TiUP 设置更长的等待超时。 > - 可能受影响的场景： > * 原集群版本低于 v6.5.7, v7.1.0 ( 没有配置项 `performance.force-init-stats` )，目标版本为 v7.2.0 及更高。 > * 原集群版本高于或等于 v6.5.7, v7.1.0 ，且配置项 `performance.force-init-stats` 被设置为 `ON`。 From f0c00ae73c2f59dda95db3ddd094cdcd1727a36a Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Fri, 8 Mar 2024 11:50:08 +0800 Subject: [PATCH 07/14] Update upgrade-tidb-using-tiup.md Co-authored-by: Roger Song --- upgrade-tidb-using-tiup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index 865379921dae..0dbe8ca4c360 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -27,7 +27,7 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u > - 配置参数 [`server-version`](/tidb-configuration-file.md#server-version) 的值会被 TiDB 节点用于验证当前 TiDB 的版本。因此在进行 TiDB 集群升级前，请将 `server-version` 的值设置为空或者当前 TiDB 真实的版本值，避免出现非预期行为。 > - 配置项 [`performance.force-init-stats`](/tidb-configuration-file.md#force-init-stats-从-v657-和-v710-版本开始引入) 设置为 `ON` 会延长 TiDB 的启动时间，这可能会造成启动超时，升级失败。为避免这种情况，建议为 TiUP 设置更长的等待超时。 > - 可能受影响的场景： -> * 原集群版本低于 v6.5.7, v7.1.0 ( 没有配置项 `performance.force-init-stats` )，目标版本为 v7.2.0 及更高。 +> * 原集群版本低于 v6.5.7, v7.1.0 ( 尚未支持 `performance.force-init-stats` )，目标版本为 v7.2.0 及更高。 > * 原集群版本高于或等于 v6.5.7, v7.1.0 ，且配置项 `performance.force-init-stats` 被设置为 `ON`。 > * 查看配置项 `performance.force-init-stats` 的值： > ``` From 22cb4544fce4fa174d6ac310259a2ebd624100c9 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Fri, 8 Mar 2024 12:11:16 +0800 Subject: [PATCH 08/14] fix format issues --- upgrade-tidb-using-tiup.md | 40 ++++++++++++++++++++++---------------- 1 file changed, 23 insertions(+), 17 deletions(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index 0dbe8ca4c360..641f74ac0714 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -26,23 +26,29 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u > - 如果原集群是 6.2 之前的版本，升级到 6.2 及以上版本时，部分场景会遇到升级卡住的情况，你可以参考[如何解决升级卡住的问题](#42-升级到-v620-及以上版本时如何解决升级卡住的问题)。 > - 配置参数 [`server-version`](/tidb-configuration-file.md#server-version) 的值会被 TiDB 节点用于验证当前 TiDB 的版本。因此在进行 TiDB 集群升级前，请将 `server-version` 的值设置为空或者当前 TiDB 真实的版本值，避免出现非预期行为。 > - 配置项 [`performance.force-init-stats`](/tidb-configuration-file.md#force-init-stats-从-v657-和-v710-版本开始引入) 设置为 `ON` 会延长 TiDB 的启动时间，这可能会造成启动超时，升级失败。为避免这种情况，建议为 TiUP 设置更长的等待超时。 -> - 可能受影响的场景： -> * 原集群版本低于 v6.5.7, v7.1.0 ( 尚未支持 `performance.force-init-stats` )，目标版本为 v7.2.0 及更高。 -> * 原集群版本高于或等于 v6.5.7, v7.1.0 ，且配置项 `performance.force-init-stats` 被设置为 `ON`。 -> * 查看配置项 `performance.force-init-stats` 的值： -> ``` -> SHOW CONFIG WHERE type = 'tidb' AND name = 'performance.force-init-stats'; -> ``` -> * 通过增加命令行选项 [`--wait-timeout`](/tiup/tiup-component-cluster.md#--wait-timeoutuint默认-120) 延长 TiUP 超时等待。如下命令可将超时等待设置成 1200 秒（即 20 分钟）。 -> ```shell -> tiup update cluster --wait-timeout 1200 [other options] -> ``` -> 通常情况下，20 分钟超时等待能满足绝大部分场景的需求。如果需要更准确的预估，可以在 TiDB 日志中搜索 `init stats info time` 关键字，获取上次启动的加载时间作为参考。 例如： -> ``` -> [domain.go:2271] ["init stats info time"] [lite=true] ["take time"=2.151333ms] -> ``` -> * 如果原数据库是 v7.1.0 或更低，升级到 v7.2.0 以上版本时，由于 [`performance.lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-从-v710-版本开始引入) 的引入，加载时间会大幅减少。这个情况下，用上述方法做的时间预估会偏长。 -> * 如果想要缩短 TiDB 滚动升级的时间，并且在升级过程中能够承受初始统计信息缺失带来的潜在性能影响。可以在升级前[用 TiUP 修改目标实例的配置](/maintain-tidb-using-tiup.md#修改配置参数)，将 `performance.force-init-stats` 设置为 `OFF`。 升级完成后可酌情改回。 +> - 可能受影响的场景： +> - 原集群版本低于 v6.5.7、v7.1.0 ( 尚未支持 `performance.force-init-stats` )，目标版本为 v7.2.0 及更高。 +> - 原集群版本高于或等于 v6.5.7、v7.1.0 ，且配置项 `performance.force-init-stats` 被设置为 `ON`。 +> - 查看配置项 `performance.force-init-stats` 的值： +> +> ``` +> SHOW CONFIG WHERE type = 'tidb' AND name = 'performance.force-init-stats'; +> ``` +> +> - 通过增加命令行选项 [`--wait-timeout`](/tiup/tiup-component-cluster.md#--wait-timeoutuint默认-120) 可以延长 TiUP 超时等待。如下命令可将超时等待设置为 1200 秒（即 20 分钟）。 +> +> ```shell +> tiup update cluster --wait-timeout 1200 [other options] +> ``` +> +> 通常情况下，20 分钟超时等待能满足绝大部分场景的需求。如果需要更准确的预估，可以在 TiDB 日志中搜索 `init stats info time` 关键字，获取上次启动的统计信息加载时间作为参考。 例如： +> +> ``` +> [domain.go:2271] ["init stats info time"] [lite=true] ["take time"=2.151333ms] +> ``` +> +> 如果原集群是 v7.1.0 或更早的版本，升级到 v7.2.0 以上版本时，由于 [`performance.lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-从-v710-版本开始引入) 的引入，统计信息加载时间会大幅减少。这个情况下，升级前的 `init stats info time` 会比升级后加载所需的时间偏长。 +> - 如果想要缩短 TiDB 滚动升级的时间，并且在升级过程中能够承受初始统计信息缺失带来的潜在性能影响，可以在升级前[用 TiUP 修改目标实例的配置](/maintain-tidb-using-tiup.md#修改配置参数)，将 `performance.force-init-stats` 设置为 `OFF`。 升级完成后可酌情改回。 ## 1. 升级兼容性说明 From 5fb92884f0110f083a00d808dc8e5d0cc24e3b07 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Fri, 8 Mar 2024 12:47:32 +0800 Subject: [PATCH 09/14] Update upgrade-tidb-using-tiup.md --- upgrade-tidb-using-tiup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index 641f74ac0714..86377e8ae2bb 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -47,7 +47,7 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u > [domain.go:2271] ["init stats info time"] [lite=true] ["take time"=2.151333ms] > ``` > -> 如果原集群是 v7.1.0 或更早的版本，升级到 v7.2.0 以上版本时，由于 [`performance.lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-从-v710-版本开始引入) 的引入，统计信息加载时间会大幅减少。这个情况下，升级前的 `init stats info time` 会比升级后加载所需的时间偏长。 +> 如果原集群是 v7.1.0 或更早的版本，升级到 v7.2.0 或以上版本时，由于 [`performance.lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-从-v710-版本开始引入) 的引入，统计信息加载时间会大幅减少。这个情况下，升级前的 `init stats info time` 会比升级后加载所需的时间偏长。 > - 如果想要缩短 TiDB 滚动升级的时间，并且在升级过程中能够承受初始统计信息缺失带来的潜在性能影响，可以在升级前[用 TiUP 修改目标实例的配置](/maintain-tidb-using-tiup.md#修改配置参数)，将 `performance.force-init-stats` 设置为 `OFF`。 升级完成后可酌情改回。 From 82dd2938df7bcea7e0367e3d929a0b7b9cf4d4b4 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Fri, 8 Mar 2024 12:51:55 +0800 Subject: [PATCH 10/14] Update upgrade-tidb-using-tiup.md --- upgrade-tidb-using-tiup.md | 1 - 1 file changed, 1 deletion(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index 86377e8ae2bb..ef45280f69cd 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -50,7 +50,6 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u > 如果原集群是 v7.1.0 或更早的版本，升级到 v7.2.0 或以上版本时，由于 [`performance.lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-从-v710-版本开始引入) 的引入，统计信息加载时间会大幅减少。这个情况下，升级前的 `init stats info time` 会比升级后加载所需的时间偏长。 > - 如果想要缩短 TiDB 滚动升级的时间，并且在升级过程中能够承受初始统计信息缺失带来的潜在性能影响，可以在升级前[用 TiUP 修改目标实例的配置](/maintain-tidb-using-tiup.md#修改配置参数)，将 `performance.force-init-stats` 设置为 `OFF`。 升级完成后可酌情改回。 - ## 1. 升级兼容性说明 - TiDB 目前暂不支持版本降级或升级后回退。 From 3fb95af692551e0f57b15e8c24c22d9a5e86df7f Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Fri, 8 Mar 2024 14:06:32 +0800 Subject: [PATCH 11/14] Apply suggestions from code review --- upgrade-tidb-using-tiup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index ef45280f69cd..ab17ffbeeb3f 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -27,7 +27,7 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u > - 配置参数 [`server-version`](/tidb-configuration-file.md#server-version) 的值会被 TiDB 节点用于验证当前 TiDB 的版本。因此在进行 TiDB 集群升级前，请将 `server-version` 的值设置为空或者当前 TiDB 真实的版本值，避免出现非预期行为。 > - 配置项 [`performance.force-init-stats`](/tidb-configuration-file.md#force-init-stats-从-v657-和-v710-版本开始引入) 设置为 `ON` 会延长 TiDB 的启动时间，这可能会造成启动超时，升级失败。为避免这种情况，建议为 TiUP 设置更长的等待超时。 > - 可能受影响的场景： -> - 原集群版本低于 v6.5.7、v7.1.0 ( 尚未支持 `performance.force-init-stats` )，目标版本为 v7.2.0 及更高。 +> - 原集群版本低于 v6.5.7、v7.1.0（尚未支持 `performance.force-init-stats`），目标版本为 v7.2.0 及更高。 > - 原集群版本高于或等于 v6.5.7、v7.1.0 ，且配置项 `performance.force-init-stats` 被设置为 `ON`。 > - 查看配置项 `performance.force-init-stats` 的值： > From 41a5a1fd21aabb3d0c532e397ae16693780a0658 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Fri, 8 Mar 2024 14:08:12 +0800 Subject: [PATCH 12/14] Update upgrade-tidb-using-tiup.md --- upgrade-tidb-using-tiup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index ab17ffbeeb3f..d61cf57f2a45 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -41,7 +41,7 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u > tiup update cluster --wait-timeout 1200 [other options] > ``` > -> 通常情况下，20 分钟超时等待能满足绝大部分场景的需求。如果需要更准确的预估，可以在 TiDB 日志中搜索 `init stats info time` 关键字，获取上次启动的统计信息加载时间作为参考。 例如： +> 通常情况下，20 分钟超时等待能满足绝大部分场景的需求。如果需要更准确的预估，可以在 TiDB 日志中搜索 `init stats info time` 关键字，获取上次启动的统计信息加载时间作为参考。例如： > > ``` > [domain.go:2271] ["init stats info time"] [lite=true] ["take time"=2.151333ms] From a5444d0496a5e19ff4fc2ad04ad6b10b264ce29c Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Fri, 8 Mar 2024 14:41:59 +0800 Subject: [PATCH 13/14] Update upgrade-tidb-using-tiup.md --- upgrade-tidb-using-tiup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index d61cf57f2a45..49f1c49f6412 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -28,7 +28,7 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u > - 配置项 [`performance.force-init-stats`](/tidb-configuration-file.md#force-init-stats-从-v657-和-v710-版本开始引入) 设置为 `ON` 会延长 TiDB 的启动时间，这可能会造成启动超时，升级失败。为避免这种情况，建议为 TiUP 设置更长的等待超时。 > - 可能受影响的场景： > - 原集群版本低于 v6.5.7、v7.1.0（尚未支持 `performance.force-init-stats`），目标版本为 v7.2.0 及更高。 -> - 原集群版本高于或等于 v6.5.7、v7.1.0 ，且配置项 `performance.force-init-stats` 被设置为 `ON`。 +> - 原集群版本高于或等于 v6.5.7、v7.1.0，且配置项 `performance.force-init-stats` 被设置为 `ON`。 > - 查看配置项 `performance.force-init-stats` 的值： > > ``` From f4e96b84d377cdd5dd20660e27d2e86fdb629395 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Sat, 9 Mar 2024 10:28:15 +0800 Subject: [PATCH 14/14] Apply suggestions from code review Co-authored-by: xixirangrang --- upgrade-tidb-using-tiup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index 49f1c49f6412..4049258ea051 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -48,7 +48,7 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u > ``` > > 如果原集群是 v7.1.0 或更早的版本，升级到 v7.2.0 或以上版本时，由于 [`performance.lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-从-v710-版本开始引入) 的引入，统计信息加载时间会大幅减少。这个情况下，升级前的 `init stats info time` 会比升级后加载所需的时间偏长。 -> - 如果想要缩短 TiDB 滚动升级的时间，并且在升级过程中能够承受初始统计信息缺失带来的潜在性能影响，可以在升级前[用 TiUP 修改目标实例的配置](/maintain-tidb-using-tiup.md#修改配置参数)，将 `performance.force-init-stats` 设置为 `OFF`。 升级完成后可酌情改回。 +> - 如果想要缩短 TiDB 滚动升级的时间，并且在升级过程中能够承受初始统计信息缺失带来的潜在性能影响，可以在升级前[用 TiUP 修改目标实例的配置](/maintain-tidb-using-tiup.md#修改配置参数)，将 `performance.force-init-stats` 设置为 `OFF`。升级完成后可酌情改回。 ## 1. 升级兼容性说明