From ba58bceebe9a160e29c9e454ba63d433364f2ec7 Mon Sep 17 00:00:00 2001 From: FiatLux Date: Sat, 19 Jun 2021 10:59:31 +0800 Subject: [PATCH 01/11] Update content about upgrade --- upgrade-tidb-using-tiup.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index d5c93e414770..82eaddbefec4 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -5,20 +5,21 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u # 使用 TiUP 升级 TiDB -本文档适用于使用 TiUP 从 TiDB 4.0 版本升级至 TiDB 5.0 版本，以及从 5.0 版本升级至后续修订版本。 +本文档适用于使用 TiUP 从 TiDB 4.0 版本升级至 TiDB 5.0 版本及后续修订版本，以及从 5.0 版本升级至后续修订版本。 如果原集群是 3.0 或 3.1 或更老的版本，需要先升级到 4.0 后再升级到 5.0，不可跨主版本升级。 ## 1. 升级兼容性说明 -- 不支持在升级后回退至 4.0 或更旧版本。 -- 使用 TiDB Ansible 管理的 4.0 版本集群，需要先按照 [4.0 版本文档的说明](https://docs.pingcap.com/zh/tidb/v4.0/upgrade-tidb-using-tiup)将集群导入到 TiUP (`tiup cluster`) 管理后，再按本文档说明升级到 5.0 版本。 +- TiDB 目前暂时不支持版本降级或升级后回退，这类功能将在未来支持。 +- 使用 TiDB Ansible 管理的 4.0 版本集群，需要先按照 [4.0 版本文档的说明](https://docs.pingcap.com/zh/tidb/v4.0/upgrade-tidb-using-tiup)将集群导入到 TiUP (`tiup cluster`) 管理后，再按本文档说明升级到 5.0 版本及后续修订版本。 - 若要将 3.0 之前的版本升级至 5.0 版本： 1. 首先[通过 TiDB Ansible 升级到 3.0 版本](https://docs.pingcap.com/zh/tidb/v3.0/upgrade-tidb-using-ansible)。 2. 然后按照 [4.0 版本文档的说明](https://docs.pingcap.com/zh/tidb/v4.0/upgrade-tidb-using-tiup)，使用 TiUP (`tiup cluster`) 将 TiDB Ansible 配置导入。 3. 将集群升级至 4.0 版本。 - 4. 按本文档说明将集群升级到 5.0 版本。 + 4. 按本文档说明将集群升级到 5.0 版本及后续修订版本。 - 支持 TiDB Binlog，TiCDC，TiFlash 等组件版本的升级。 +- 具体不同版本的兼容性说明，请查看各个版本的 [Release Note](https://docs.pingcap.com/zh/tidb/dev/release-notes)。请根据各个版本的 Release Note 的兼容性更改调整集群的配置。 > **注意：** > @@ -248,4 +249,4 @@ tiup install ctl:v5.0.0 ## 5. TiDB 5.1 兼容性变化 - 兼容性变化请参考 5.1 GA Release Notes。 -- 请避免在对使用 TiDB-Binlog 的集群进行滚动升级过程中新创建聚簇索引表。 \ No newline at end of file +- 请避免在对使用 TiDB-Binlog 的集群进行滚动升级过程中新创建聚簇索引表。 From 11bf403378ea67cc050eb6a9dae5c3d00641563c Mon Sep 17 00:00:00 2001 From: FiatLux Date: Sat, 19 Jun 2021 20:13:01 +0800 Subject: [PATCH 02/11] Update upgrade-tidb-using-tiup.md Co-authored-by: Grace Cai --- 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 82eaddbefec4..f71b07ccd70e 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -11,7 +11,7 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u ## 1. 升级兼容性说明 -- TiDB 目前暂时不支持版本降级或升级后回退，这类功能将在未来支持。 +- TiDB 目前暂不支持版本降级或升级后回退，此类功能将在未来支持。 - 使用 TiDB Ansible 管理的 4.0 版本集群，需要先按照 [4.0 版本文档的说明](https://docs.pingcap.com/zh/tidb/v4.0/upgrade-tidb-using-tiup)将集群导入到 TiUP (`tiup cluster`) 管理后，再按本文档说明升级到 5.0 版本及后续修订版本。 - 若要将 3.0 之前的版本升级至 5.0 版本： 1. 首先[通过 TiDB Ansible 升级到 3.0 版本](https://docs.pingcap.com/zh/tidb/v3.0/upgrade-tidb-using-ansible)。 From 1a283d4c9edca00ed1778ecc0c61cbd05179dd1c Mon Sep 17 00:00:00 2001 From: FiatLux Date: Sat, 19 Jun 2021 20:13:10 +0800 Subject: [PATCH 03/11] Update upgrade-tidb-using-tiup.md Co-authored-by: Grace Cai --- 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 f71b07ccd70e..9e795277cb73 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -248,5 +248,5 @@ tiup install ctl:v5.0.0 ## 5. TiDB 5.1 兼容性变化 -- 兼容性变化请参考 5.1 GA Release Notes。 +- 兼容性变化请参考 5.1 Release Notes。 - 请避免在对使用 TiDB-Binlog 的集群进行滚动升级过程中新创建聚簇索引表。 From 029a4d2a1bcb8c43d07917be5d64e5dbf9f384b3 Mon Sep 17 00:00:00 2001 From: FiatLux Date: Sat, 19 Jun 2021 20:13:39 +0800 Subject: [PATCH 04/11] Update upgrade-tidb-using-tiup.md Co-authored-by: Grace Cai --- upgrade-tidb-using-tiup.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index 9e795277cb73..f72dcabb2ada 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -5,9 +5,12 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u # 使用 TiUP 升级 TiDB -本文档适用于使用 TiUP 从 TiDB 4.0 版本升级至 TiDB 5.0 版本及后续修订版本，以及从 5.0 版本升级至后续修订版本。 +本文档适用于以下升级路径： +- 使用 TiUP 从 TiDB 4.0 版本升级至 TiDB 5.1 及后续修订版本。 +- 使用 TiUP 从 TiDB 5.0 版本升级至 TiDB 5.1 及后续修订版本。 -如果原集群是 3.0 或 3.1 或更老的版本，需要先升级到 4.0 后再升级到 5.0，不可跨主版本升级。 +> **注意：** +> 如果原集群是 3.0 或 3.1 或更老的版本，不支持直接升级到 5.1 及后续修订版本。你需要先从老版本升级到 4.0 后，再从 4.0 升级到 5.1 及后续修订版本。 ## 1. 升级兼容性说明 From 1bcf67c3c78798524e5c5f4675475d4832b2fee2 Mon Sep 17 00:00:00 2001 From: FiatLux Date: Sat, 19 Jun 2021 20:15:02 +0800 Subject: [PATCH 05/11] 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 f72dcabb2ada..d2b6dfaf40eb 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -20,7 +20,7 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u 1. 首先[通过 TiDB Ansible 升级到 3.0 版本](https://docs.pingcap.com/zh/tidb/v3.0/upgrade-tidb-using-ansible)。 2. 然后按照 [4.0 版本文档的说明](https://docs.pingcap.com/zh/tidb/v4.0/upgrade-tidb-using-tiup)，使用 TiUP (`tiup cluster`) 将 TiDB Ansible 配置导入。 3. 将集群升级至 4.0 版本。 - 4. 按本文档说明将集群升级到 5.0 版本及后续修订版本。 + 4. 按本文档说明将集群升级到 5.1 版本。 - 支持 TiDB Binlog，TiCDC，TiFlash 等组件版本的升级。 - 具体不同版本的兼容性说明，请查看各个版本的 [Release Note](https://docs.pingcap.com/zh/tidb/dev/release-notes)。请根据各个版本的 Release Note 的兼容性更改调整集群的配置。 From bf0ca8b22fb042ec092cbc63a82e60a84b0cb75b Mon Sep 17 00:00:00 2001 From: FiatLux Date: Sat, 19 Jun 2021 21:00:44 +0800 Subject: [PATCH 06/11] Update upgrade-tidb-using-tiup.md --- upgrade-tidb-using-tiup.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index d2b6dfaf40eb..390bef480c60 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -15,8 +15,8 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u ## 1. 升级兼容性说明 - TiDB 目前暂不支持版本降级或升级后回退，此类功能将在未来支持。 -- 使用 TiDB Ansible 管理的 4.0 版本集群，需要先按照 [4.0 版本文档的说明](https://docs.pingcap.com/zh/tidb/v4.0/upgrade-tidb-using-tiup)将集群导入到 TiUP (`tiup cluster`) 管理后，再按本文档说明升级到 5.0 版本及后续修订版本。 -- 若要将 3.0 之前的版本升级至 5.0 版本： +- 使用 TiDB Ansible 管理的 4.0 版本集群，需要先按照 [4.0 版本文档的说明](https://docs.pingcap.com/zh/tidb/v4.0/upgrade-tidb-using-tiup)将集群导入到 TiUP (`tiup cluster`) 管理后，再按本文档说明升级到 5.1 版本及后续修订版本。 +- 若要将 3.0 之前的版本升级至 5.1 版本： 1. 首先[通过 TiDB Ansible 升级到 3.0 版本](https://docs.pingcap.com/zh/tidb/v3.0/upgrade-tidb-using-ansible)。 2. 然后按照 [4.0 版本文档的说明](https://docs.pingcap.com/zh/tidb/v4.0/upgrade-tidb-using-tiup)，使用 TiUP (`tiup cluster`) 将 TiDB Ansible 配置导入。 3. 将集群升级至 4.0 版本。 @@ -40,7 +40,7 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u > > 如果原集群中控机不能访问 `https://tiup-mirrors.pingcap.com` 地址，可跳到步骤 2.2 使用离线升级方式。 -1. 先升级 TiUP 版本（建议 `tiup` 版本不低于 `1.4.0`）： +1. 先升级 TiUP 版本（建议 `tiup` 版本不低于 `1.5.0`）： {{< copyable "shell-regular" >}} @@ -49,7 +49,7 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u tiup --version ``` -2. 再升级 TiUP Cluster 版本（建议 `tiup cluster` 版本不低于 `1.4.0`）： +2. 再升级 TiUP Cluster 版本（建议 `tiup cluster` 版本不低于 `1.5.0`）： {{< copyable "shell-regular" >}} @@ -91,7 +91,7 @@ tiup update cluster > 以下情况可跳过此步骤： > > - 原集群没有修改过配置参数，或通过 tiup cluster 修改过参数但不需要调整。 -> - 升级后对未修改过的配置项希望使用 `5.0` 默认参数。 +> - 升级后对未修改过的配置项希望使用 `5.1` 默认参数。 1. 进入拓扑文件的 `vi` 编辑模式： @@ -107,9 +107,9 @@ tiup update cluster > **注意：** > -> 升级到 5.0 版本前，请确认已在 4.0 修改的参数在 5.0 版本中是兼容的，可参考 [TiKV 配置文件描述](/tikv-configuration-file.md)。 +> 升级到 5.1 版本前，请确认已在 4.0 修改的参数在 5.1 版本中是兼容的，可参考 [TiKV 配置文件描述](/tikv-configuration-file.md)。 > -> 以下 TiKV 参数在 TiDB v5.0 已废弃。如果在原集群配置过以下参数，需要通过 `edit-config` 编辑模式删除这些参数: +> 以下 TiKV 参数在 TiDB v5.1 已废弃。如果在原集群配置过以下参数，需要通过 `edit-config` 编辑模式删除这些参数: > > - pessimistic-txn.enabled > - server.request-batch-enable-cross-command @@ -143,12 +143,12 @@ tiup cluster check --cluster tiup cluster upgrade ``` -以升级到 5.0.0 版本为例： +以升级到 5.1.0 版本为例： {{< copyable "shell-regular" >}} ``` -tiup cluster upgrade v5.0.0 +tiup cluster upgrade v5.1.0 ``` > **注意：** @@ -196,7 +196,7 @@ tiup cluster display ``` Cluster type: tidb Cluster name: -Cluster version: v5.0.0 +Cluster version: v5.1.0 ``` > **注意：** @@ -246,7 +246,7 @@ tiup cluster upgrade --force {{< copyable "" >}} ``` -tiup install ctl:v5.0.0 +tiup install ctl:v5.1.0 ``` ## 5. TiDB 5.1 兼容性变化 From 45f8680713ef55fe68acf8f709b72a514832c83a Mon Sep 17 00:00:00 2001 From: FiatLux Date: Mon, 21 Jun 2021 10:44:10 +0800 Subject: [PATCH 07/11] Update upgrade-tidb-using-tiup.md Co-authored-by: Grace Cai --- 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 390bef480c60..ff25dc2d9194 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -22,7 +22,7 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u 3. 将集群升级至 4.0 版本。 4. 按本文档说明将集群升级到 5.1 版本。 - 支持 TiDB Binlog，TiCDC，TiFlash 等组件版本的升级。 -- 具体不同版本的兼容性说明，请查看各个版本的 [Release Note](https://docs.pingcap.com/zh/tidb/dev/release-notes)。请根据各个版本的 Release Note 的兼容性更改调整集群的配置。 +- 具体不同版本的兼容性说明，请查看各个版本的 [Release Note](/release-notes.md)。请根据各个版本的 Release Note 的兼容性更改调整集群的配置。 > **注意：** > From e00f926003aab0a10287bc8863a9406c16163b1b Mon Sep 17 00:00:00 2001 From: TomShawn <41534398+TomShawn@users.noreply.github.com> Date: Mon, 21 Jun 2021 17:38:32 +0800 Subject: [PATCH 08/11] Update upgrade-tidb-using-tiup.md --- upgrade-tidb-using-tiup.md | 1 + 1 file changed, 1 insertion(+) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index ff25dc2d9194..7f0ed5f31b7c 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -10,6 +10,7 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u - 使用 TiUP 从 TiDB 5.0 版本升级至 TiDB 5.1 及后续修订版本。 > **注意：** +> > 如果原集群是 3.0 或 3.1 或更老的版本，不支持直接升级到 5.1 及后续修订版本。你需要先从老版本升级到 4.0 后，再从 4.0 升级到 5.1 及后续修订版本。 ## 1. 升级兼容性说明 From d106ec1a04989ea48e8e7571149e59d97c7157bf Mon Sep 17 00:00:00 2001 From: TomShawn <41534398+TomShawn@users.noreply.github.com> Date: Mon, 21 Jun 2021 17:38:39 +0800 Subject: [PATCH 09/11] Update upgrade-tidb-using-tiup.md Co-authored-by: FiatLux --- 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 7f0ed5f31b7c..609d166375c1 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -15,7 +15,7 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u ## 1. 升级兼容性说明 -- TiDB 目前暂不支持版本降级或升级后回退，此类功能将在未来支持。 +- TiDB 目前暂不支持版本降级或升级后回退。 - 使用 TiDB Ansible 管理的 4.0 版本集群，需要先按照 [4.0 版本文档的说明](https://docs.pingcap.com/zh/tidb/v4.0/upgrade-tidb-using-tiup)将集群导入到 TiUP (`tiup cluster`) 管理后，再按本文档说明升级到 5.1 版本及后续修订版本。 - 若要将 3.0 之前的版本升级至 5.1 版本： 1. 首先[通过 TiDB Ansible 升级到 3.0 版本](https://docs.pingcap.com/zh/tidb/v3.0/upgrade-tidb-using-ansible)。 From a6bb7bed9b036595c58de7a9a9799de633b63698 Mon Sep 17 00:00:00 2001 From: TomShawn <41534398+TomShawn@users.noreply.github.com> Date: Mon, 21 Jun 2021 17:43:31 +0800 Subject: [PATCH 10/11] Apply suggestions from code review --- 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 609d166375c1..967f933ad446 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -6,12 +6,13 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u # 使用 TiUP 升级 TiDB 本文档适用于以下升级路径： + - 使用 TiUP 从 TiDB 4.0 版本升级至 TiDB 5.1 及后续修订版本。 - 使用 TiUP 从 TiDB 5.0 版本升级至 TiDB 5.1 及后续修订版本。 -> **注意：** +> **注意：** > -> 如果原集群是 3.0 或 3.1 或更老的版本，不支持直接升级到 5.1 及后续修订版本。你需要先从老版本升级到 4.0 后，再从 4.0 升级到 5.1 及后续修订版本。 +> 如果原集群是 3.0 或 3.1 或更早的版本，不支持直接升级到 5.1 及后续修订版本。你需要先从早期版本升级到 4.0 后，再从 4.0 升级到 5.1 及后续修订版本。 ## 1. 升级兼容性说明 From 962624fcf495f545b3ea82e8a924cb234c401076 Mon Sep 17 00:00:00 2001 From: TomShawn <41534398+TomShawn@users.noreply.github.com> Date: Mon, 21 Jun 2021 19:08:59 +0800 Subject: [PATCH 11/11] 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 967f933ad446..d128de327417 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -24,7 +24,7 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u 3. 将集群升级至 4.0 版本。 4. 按本文档说明将集群升级到 5.1 版本。 - 支持 TiDB Binlog，TiCDC，TiFlash 等组件版本的升级。 -- 具体不同版本的兼容性说明，请查看各个版本的 [Release Note](/release-notes.md)。请根据各个版本的 Release Note 的兼容性更改调整集群的配置。 +- 具体不同版本的兼容性说明，请查看各个版本的 [Release Note](/releases/release-notes.md)。请根据各个版本的 Release Note 的兼容性更改调整集群的配置。 > **注意：** >