From 3f07a05529cbbcc66bf308c9396d9d67e37e22a4 Mon Sep 17 00:00:00 2001 From: Win-Man <825895587@qq.com> Date: Fri, 29 May 2020 22:01:20 +0800 Subject: [PATCH] TiUP:Add tiup upgrade notice (#3412) * Update tiup upgrade doc * Fix tiup cluster display output * Update upgrade-tidb-using-tiup.md Co-authored-by: Keke Yi <40977455+yikeke@users.noreply.github.com> --- upgrade-tidb-using-tiup.md | 24 ++++++++++++++++++------ 1 file changed, 18 insertions(+), 6 deletions(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index 1db146fbb791..9dfce13c3c93 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -67,6 +67,10 @@ aliases: ['/docs-cn/stable/how-to/upgrade/using-tiup/'] tiup update cluster ``` +> **注意：** +> +> 如果 `tiup --version` 显示 `tiup` 版本低于 `v1.0.0`，请在执行 `tiup update cluster` 之前先执行 `tiup update --self` 命令更新 `tiup` 版本。 + ## 3. 将 TiDB Ansible 及 `inventory.ini` 配置导入到 TiUP > **注意：** @@ -140,12 +144,20 @@ tiup update cluster 本部分介绍如何滚动升级 TiDB 集群以及升级后的验证。 -### 4.1 将集群升级到 v4.0.0-rc 版本 +### 4.1 将集群升级到指定版本 {{< copyable "shell-regular" >}} ```shell -tiup cluster upgrade v4.0.0-rc +tiup cluster upgrade +``` + +以升级到 v4.0.0 版本为例： + +{{< copyable "shell-regular" >}} + +``` +tiup cluster upgrade v4.0.0 ``` 滚动升级会逐个升级所有的组件。升级 TiKV 期间，会逐个将 TiKV 上的所有 leader 切走再停止该 TiKV 实例。默认超时时间为 5 分钟，超过后会直接停止实例。 @@ -165,9 +177,9 @@ tiup cluster display ``` ``` -Starting /home/tidblk/.tiup/components/cluster/v0.4.3/cluster display +Starting /home/tidblk/.tiup/components/cluster/v1.0.0/cluster display TiDB Cluster: -TiDB Version: v4.0.0-rc +TiDB Version: v4.0.0 ``` ## 5. 升级 FAQ @@ -185,12 +197,12 @@ TiDB Version: v4.0.0-rc {{< copyable "shell-regular" >}} ```shell -tiup cluster upgrade v4.0.0-rc --force +tiup cluster upgrade v4.0.0 --force ``` ### 5.3 升级完成后，如何更新 pd-ctl 等周边工具版本 -目前 TiUP 没有对周边工具的版本进行管理更新，如需下载最新版本的工具包，直接下载 TiDB 安装包即可，将 `{version}` 替换为对应的版本如 `v4.0.0-rc`，下载地址如下： +目前 TiUP 没有对周边工具的版本进行管理更新，如需下载最新版本的工具包，直接下载 TiDB 安装包即可，将 `{version}` 替换为对应的版本如 `v4.0.0`，下载地址如下： {{< copyable "" >}}