Skip to content

TiUP:Add tiup upgrade notice (#3412) #3414

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
May 29, 2020
Merged

TiUP:Add tiup upgrade notice (#3412) #3414

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
24 changes: 18 additions & 6 deletions upgrade-tidb-using-tiup.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

> **注意：**
Expand Down Expand Up @@ -140,12 +144,20 @@ tiup update cluster

本部分介绍如何滚动升级 TiDB 集群以及升级后的验证。

### 4.1 将集群升级到 v4.0.0-rc 版本
### 4.1 将集群升级到指定版本

{{< copyable "shell-regular" >}}

```shell
tiup cluster upgrade <cluster-name> v4.0.0-rc
tiup cluster upgrade <cluster-name> <version>
```

以升级到 v4.0.0 版本为例：

{{< copyable "shell-regular" >}}

```
tiup cluster upgrade <cluster-name> v4.0.0
```

滚动升级会逐个升级所有的组件。升级 TiKV 期间，会逐个将 TiKV 上的所有 leader 切走再停止该 TiKV 实例。默认超时时间为 5 分钟，超过后会直接停止实例。
Expand All @@ -165,9 +177,9 @@ tiup cluster display <cluster-name>
```

```
Starting /home/tidblk/.tiup/components/cluster/v0.4.3/cluster display <cluster-name>
Starting /home/tidblk/.tiup/components/cluster/v1.0.0/cluster display <cluster-name>
TiDB Cluster: <cluster-name>
TiDB Version: v4.0.0-rc
TiDB Version: v4.0.0
```

## 5. 升级 FAQ
Expand All @@ -185,12 +197,12 @@ TiDB Version: v4.0.0-rc
{{< copyable "shell-regular" >}}

```shell
tiup cluster upgrade <cluster-name> v4.0.0-rc --force
tiup cluster upgrade <cluster-name> v4.0.0 --force
```

### 5.3 升级完成后，如何更新 pd-ctl 等周边工具版本

目前 TiUP 没有对周边工具的版本进行管理更新，如需下载最新版本的工具包，直接下载 TiDB 安装包即可，将 `{version}` 替换为对应的版本如 `v4.0.0-rc`，下载地址如下：
目前 TiUP 没有对周边工具的版本进行管理更新，如需下载最新版本的工具包，直接下载 TiDB 安装包即可，将 `{version}` 替换为对应的版本如 `v4.0.0`，下载地址如下：

{{< copyable "" >}}

Expand Down