Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 9 additions & 1 deletion upgrade-tidb-using-tiup.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 部署的集群,暂不支持导入:
Expand All @@ -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

Expand Down