From 10ba02de9c63198628f02649f1451a05b1a69232 Mon Sep 17 00:00:00 2001 From: gengliqi Date: Fri, 5 Sep 2025 01:00:36 +0800 Subject: [PATCH 1/8] add graceful-shutdown-wait-timeout Signed-off-by: gengliqi --- tiflash/tiflash-configuration.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/tiflash/tiflash-configuration.md b/tiflash/tiflash-configuration.md index 0c03f48d5c725..af742a3b36629 100644 --- a/tiflash/tiflash-configuration.md +++ b/tiflash/tiflash-configuration.md @@ -251,6 +251,12 @@ The following configuration items only take effect for the TiFlash disaggregated - This configuration item only takes effect for the TiFlash disaggregated storage and compute architecture mode. For details, see [TiFlash Disaggregated Storage and Compute Architecture and S3 Support](/tiflash/tiflash-disaggregated-and-s3.md). - Value options: `"tiflash_write"`, `"tiflash_compute"` +##### `graceful_wait_shutdown_timeout` + +- Specifies the number of seconds that the TiFlash server waits for when you shut down the TiFlash server, which allows the remaining MPP tasks to execute and does not accept any new MPP tasks. If all the MPP tasks are finished before this timeout, TiFlash will shut down immediately. +- Default value: 600 +- When one TiFlash server is waiting for shutdown (in the grace period), the TiDB will not send any new task to this TiFlash server. + #### flash.proxy ##### `addr` From d1b42035274b12fbc92aa4d3f20b3c30409ffa76 Mon Sep 17 00:00:00 2001 From: gengliqi Date: Fri, 5 Sep 2025 01:28:17 +0800 Subject: [PATCH 2/8] u Signed-off-by: gengliqi --- tiflash/tiflash-configuration.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/tiflash/tiflash-configuration.md b/tiflash/tiflash-configuration.md index af742a3b36629..8e54bb40551b8 100644 --- a/tiflash/tiflash-configuration.md +++ b/tiflash/tiflash-configuration.md @@ -253,8 +253,8 @@ The following configuration items only take effect for the TiFlash disaggregated ##### `graceful_wait_shutdown_timeout` -- Specifies the number of seconds that the TiFlash server waits for when you shut down the TiFlash server, which allows the remaining MPP tasks to execute and does not accept any new MPP tasks. If all the MPP tasks are finished before this timeout, TiFlash will shut down immediately. -- Default value: 600 +- Specifies the maximum number of seconds that the TiFlash server waits for when you shut down the TiFlash server, which allows the remaining MPP tasks to execute and does not accept any new MPP tasks. If all the MPP tasks are finished before this timeout, TiFlash will shut down immediately. +- Default value: `600` - When one TiFlash server is waiting for shutdown (in the grace period), the TiDB will not send any new task to this TiFlash server. #### flash.proxy From 7fbe36935709c1ec5150ee0e9ca5c337a4ccda59 Mon Sep 17 00:00:00 2001 From: gengliqi Date: Fri, 5 Sep 2025 01:30:51 +0800 Subject: [PATCH 3/8] u Signed-off-by: gengliqi --- tiflash/tiflash-configuration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tiflash/tiflash-configuration.md b/tiflash/tiflash-configuration.md index 8e54bb40551b8..68dec6316df15 100644 --- a/tiflash/tiflash-configuration.md +++ b/tiflash/tiflash-configuration.md @@ -255,7 +255,7 @@ The following configuration items only take effect for the TiFlash disaggregated - Specifies the maximum number of seconds that the TiFlash server waits for when you shut down the TiFlash server, which allows the remaining MPP tasks to execute and does not accept any new MPP tasks. If all the MPP tasks are finished before this timeout, TiFlash will shut down immediately. - Default value: `600` -- When one TiFlash server is waiting for shutdown (in the grace period), the TiDB will not send any new task to this TiFlash server. +- When one TiFlash server is waiting for shutdown (in the grace period), the TiDB will not send any new MPP task to this TiFlash server. #### flash.proxy From dbdcfbc6d87e534300afeb3bbb91b5f3430f104c Mon Sep 17 00:00:00 2001 From: Liqi Geng Date: Thu, 11 Sep 2025 14:50:30 +0800 Subject: [PATCH 4/8] Update tiflash/tiflash-configuration.md Co-authored-by: Grace Cai --- tiflash/tiflash-configuration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tiflash/tiflash-configuration.md b/tiflash/tiflash-configuration.md index 68dec6316df15..5fb8f0bf25953 100644 --- a/tiflash/tiflash-configuration.md +++ b/tiflash/tiflash-configuration.md @@ -251,7 +251,7 @@ The following configuration items only take effect for the TiFlash disaggregated - This configuration item only takes effect for the TiFlash disaggregated storage and compute architecture mode. For details, see [TiFlash Disaggregated Storage and Compute Architecture and S3 Support](/tiflash/tiflash-disaggregated-and-s3.md). - Value options: `"tiflash_write"`, `"tiflash_compute"` -##### `graceful_wait_shutdown_timeout` +##### `graceful_wait_shutdown_timeout` New in v9.0.0 - Specifies the maximum number of seconds that the TiFlash server waits for when you shut down the TiFlash server, which allows the remaining MPP tasks to execute and does not accept any new MPP tasks. If all the MPP tasks are finished before this timeout, TiFlash will shut down immediately. - Default value: `600` From 8f5c9b29031b9abc5a38ef70d83d089856a4b2bb Mon Sep 17 00:00:00 2001 From: Liqi Geng Date: Thu, 11 Sep 2025 14:51:02 +0800 Subject: [PATCH 5/8] Update tiflash/tiflash-configuration.md Co-authored-by: Grace Cai --- tiflash/tiflash-configuration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tiflash/tiflash-configuration.md b/tiflash/tiflash-configuration.md index 5fb8f0bf25953..b7d243a34a3af 100644 --- a/tiflash/tiflash-configuration.md +++ b/tiflash/tiflash-configuration.md @@ -253,7 +253,7 @@ The following configuration items only take effect for the TiFlash disaggregated ##### `graceful_wait_shutdown_timeout` New in v9.0.0 -- Specifies the maximum number of seconds that the TiFlash server waits for when you shut down the TiFlash server, which allows the remaining MPP tasks to execute and does not accept any new MPP tasks. If all the MPP tasks are finished before this timeout, TiFlash will shut down immediately. +- Controls the maximum wait time when shutting down a TiFlash server. During this period, TiFlash continues running unfinished MPP tasks but does not accept new ones. If all running MPP tasks finish before this timeout, TiFlash shuts down immediately; otherwise, it is forcibly shut down after the wait time expires. - Default value: `600` - When one TiFlash server is waiting for shutdown (in the grace period), the TiDB will not send any new MPP task to this TiFlash server. From dc44d21b1a0e13320756c1408c26d317bef67610 Mon Sep 17 00:00:00 2001 From: Liqi Geng Date: Thu, 11 Sep 2025 14:51:19 +0800 Subject: [PATCH 6/8] Update tiflash/tiflash-configuration.md Co-authored-by: Grace Cai --- tiflash/tiflash-configuration.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/tiflash/tiflash-configuration.md b/tiflash/tiflash-configuration.md index b7d243a34a3af..c5e73f9295aee 100644 --- a/tiflash/tiflash-configuration.md +++ b/tiflash/tiflash-configuration.md @@ -254,8 +254,8 @@ The following configuration items only take effect for the TiFlash disaggregated ##### `graceful_wait_shutdown_timeout` New in v9.0.0 - Controls the maximum wait time when shutting down a TiFlash server. During this period, TiFlash continues running unfinished MPP tasks but does not accept new ones. If all running MPP tasks finish before this timeout, TiFlash shuts down immediately; otherwise, it is forcibly shut down after the wait time expires. -- Default value: `600` -- When one TiFlash server is waiting for shutdown (in the grace period), the TiDB will not send any new MPP task to this TiFlash server. +- Unit: seconds +- While the TiFlash server is waiting to shut down (in the grace period), TiDB will not send new MPP tasks to it. #### flash.proxy From d32e75ff9b78d2846fc3e3257d31d73ca1e009b2 Mon Sep 17 00:00:00 2001 From: Liqi Geng Date: Tue, 16 Sep 2025 15:51:49 +0800 Subject: [PATCH 7/8] Update tiflash/tiflash-configuration.md Co-authored-by: Grace Cai --- tiflash/tiflash-configuration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tiflash/tiflash-configuration.md b/tiflash/tiflash-configuration.md index c5e73f9295aee..95ebc71920d11 100644 --- a/tiflash/tiflash-configuration.md +++ b/tiflash/tiflash-configuration.md @@ -251,7 +251,7 @@ The following configuration items only take effect for the TiFlash disaggregated - This configuration item only takes effect for the TiFlash disaggregated storage and compute architecture mode. For details, see [TiFlash Disaggregated Storage and Compute Architecture and S3 Support](/tiflash/tiflash-disaggregated-and-s3.md). - Value options: `"tiflash_write"`, `"tiflash_compute"` -##### `graceful_wait_shutdown_timeout` New in v9.0.0 +##### `graceful_wait_shutdown_timeout` New in v8.5.4 and v9.0.0 - Controls the maximum wait time when shutting down a TiFlash server. During this period, TiFlash continues running unfinished MPP tasks but does not accept new ones. If all running MPP tasks finish before this timeout, TiFlash shuts down immediately; otherwise, it is forcibly shut down after the wait time expires. - Unit: seconds From c738e3ffa4bfbd91e9d94a7b023be9586cd1ab1b Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Mon, 3 Nov 2025 15:40:07 +0800 Subject: [PATCH 8/8] Update tiflash/tiflash-configuration.md Co-authored-by: Aolin --- tiflash/tiflash-configuration.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/tiflash/tiflash-configuration.md b/tiflash/tiflash-configuration.md index 95ebc71920d11..16a52fbdfd5db 100644 --- a/tiflash/tiflash-configuration.md +++ b/tiflash/tiflash-configuration.md @@ -253,8 +253,9 @@ The following configuration items only take effect for the TiFlash disaggregated ##### `graceful_wait_shutdown_timeout` New in v8.5.4 and v9.0.0 -- Controls the maximum wait time when shutting down a TiFlash server. During this period, TiFlash continues running unfinished MPP tasks but does not accept new ones. If all running MPP tasks finish before this timeout, TiFlash shuts down immediately; otherwise, it is forcibly shut down after the wait time expires. -- Unit: seconds +- Controls the maximum wait time when shutting down a TiFlash server. During this period, TiFlash continues running unfinished MPP tasks but does not accept new ones. If all running MPP tasks finish before this timeout, TiFlash shuts down immediately; otherwise, it is forcibly shut down after the wait time expires. +- Default value: `600` +- Unit: seconds - While the TiFlash server is waiting to shut down (in the grace period), TiDB will not send new MPP tasks to it. #### flash.proxy