From 7a1a293b6afcad37fb30133edaebc7a2a37f9324 Mon Sep 17 00:00:00 2001 From: superlzs0476 Date: Wed, 3 Jun 2020 15:17:46 +0800 Subject: [PATCH] add tips for upgrade v4.0 use of tiup --- upgrade-tidb-using-tiup.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index 26e427be48e4..3d0787e5c4c1 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -12,7 +12,7 @@ aliases: ['/docs-cn/dev/how-to/upgrade/using-tiup/'] ## 1. 升级兼容性说明 -- 不支持在升级后回退至 3.0 版本。 +- 不支持在升级后回退至 3.0 或更旧版本。 - 3.0 之前的版本，需要先通过 TiDB Ansible 升级到 3.0 版本，然后按照本文档的说明，使用 TiUP 将 TiDB Ansible 配置导入，再升级到 4.0 版本。 - TiDB Ansible 配置导入到 TiUP 中管理后，不能再通过 TiDB Ansible 对集群进行操作，否则可能因元信息不一致造成冲突。 - 对于满足以下情况之一的 TiDB Ansible 部署的集群，暂不支持导入： @@ -24,6 +24,14 @@ aliases: ['/docs-cn/dev/how-to/upgrade/using-tiup/'] - 仍使用老版本 `'push'` 的方式收集监控指标（从 3.0 默认为 `'pull'` 模式，如果没有特意调整过则可以支持） - 在 `inventory.ini` 配置文件中单独为机器的 node_exporter / blackbox_exporter 通过 `node_exporter_port` / `blackbox_exporter_port` 设置了非默认端口（在 `group_vars` 目录中统一配置的可以兼容） - 支持 TiDB Binlog，TiCDC，TiFlash 等组件版本的升级。 +- 从 2.0.6 之前的版本升级到 4.0.0 之前，需要确认集群中是否存在正在运行中的 DDL 操作，特别是耗时的 `Add Index` 操作，等 DDL 操作完成后再执行升级操作 +- 2.1 及之后版本启用了并行 DDL，早于 2.0.1 版本的集群，无法滚动升级到 4.0.0 版本，可以选择下面两种方案： + - 停机升级，直接从早于 2.0.1 的 TiDB 版本升级到 4.0.0 版本 + - 先滚动升级到 2.0.1 或者之后的 2.0.x 版本，再滚动升级到 4.0.0 版本 + +> **注意：** +> +> 在升级的过程中不要执行 DDL 请求，否则可能会出现行为未定义的问题。 ## 2. 在中控机器上安装 TiUP