forked from pingcap/docs-cn
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
*: add and update 2.1 upgrade docs (pingcap#999)
- Loading branch information
1 parent
ccd11ec
commit e1ae04c
Showing
9 changed files
with
198 additions
and
69 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,110 @@ | ||
| --- | ||
| title: TiDB 2.1 升级操作指南 | ||
| category: deployment | ||
| --- | ||
|
|
||
| # TiDB 2.1 升级操作指南 | ||
|
|
||
| 本文档适用于从 TiDB 2.0 版本（v2.0.1 及之后版本）或 TiDB 2.1 rc 版本升级到 TiDB 2.1 GA 版本。2.1 版本 TiDB-Binlog 不兼容 Kafka 版本，如果当前集群已经使用 Kafka 版本的 TiDB-Binlog，升级需要参考 [Binlog 升级方法](../tools/tidb-binlog-cluster.md#版本升级方法)。 | ||
|
|
||
| ## 在中控机器上安装 Ansible 及其依赖 | ||
|
|
||
| TiDB-Ansible release-2.1 版本依赖 2.4.2 及以上但不高于 2.7.0 的 Ansible 版本（`ansible>=2.4.2,<2.7.0`），另依赖 Python 模块：`jinja2>=2.9.6` 和 `jmespath>=0.9.0`。为方便管理依赖，新版本使用 `pip` 安装 Ansible 及其依赖，可参照[在中控机器上安装 Ansible 及其依赖](../op-guide/ansible-deployment.md#在中控机器上安装-ansible-及其依赖) 进行安装。离线环境参照[在中控机器上离线安装 Ansible 及其依赖](../op-guide/offline-ansible-deployment.md#在中控机器上离线安装-ansible-及其依赖)。 | ||
|
|
||
| 安装完成后，可通过以下命令查看版本： | ||
|
|
||
| ``` | ||
| $ ansible --version | ||
| ansible 2.6.8 | ||
| $ pip show jinja2 | ||
| Name: Jinja2 | ||
| Version: 2.10 | ||
| $ pip show jmespath | ||
| Name: jmespath | ||
| Version: 0.9.3 | ||
| ``` | ||
|
|
||
| > **注意**：请务必按以上文档安装 Ansible 及其依赖。确认 Jinja2 版本是否正确，否则启动 Grafana 时会报错。确认 jmespath 版本是否正确，否则滚动升级 TiKV 时会报错。 | ||
| ## 在中控机器上下载 TiDB-Ansible | ||
|
|
||
| 以 `tidb` 用户登录中控机并进入 `/home/tidb` 目录，备份 TiDB 2.0 版本或 TiDB 2.1 rc 版本的 tidb-ansible 文件夹： | ||
|
|
||
| ``` | ||
| $ mv tidb-ansible tidb-ansible-bak | ||
| ``` | ||
|
|
||
| 下载最新 tidb-ansible release-2.1 分支，默认的文件夹名称为 `tidb-ansible`。 | ||
|
|
||
| ``` | ||
| $ git clone -b release-2.1 https://github.com/pingcap/tidb-ansible.git | ||
| ``` | ||
|
|
||
| ## 编辑 inventory.ini 文件和配置文件 | ||
|
|
||
| 以 `tidb` 用户登录中控机并进入 `/home/tidb/tidb-ansible` 目录。 | ||
|
|
||
| ### 编辑 `inventory.ini` 文件 | ||
|
|
||
| 编辑 `inventory.ini` 文件，IP 信息参照备份文件 `/home/tidb/tidb-ansible-bak/inventory.ini`。 | ||
|
|
||
| 以下变量配置，需要重点确认，变量含义可参考 [inventory.ini 变量调整](../op-guide/ansible-deployment.md#其他变量调整)。 | ||
|
|
||
| 1. 请确认 `ansible_user` 配置的是普通用户。为统一权限管理，不再支持使用 root 用户远程安装。默认配置中使用 `tidb` 用户作为 SSH 远程用户及程序运行用户。 | ||
|
|
||
| ``` | ||
| ## Connection | ||
| # ssh via normal user | ||
| ansible_user = tidb | ||
| ``` | ||
| 可参考[如何配置 ssh 互信及 sudo 规则](../op-guide/ansible-deployment.md#在中控机上配置部署机器-ssh-互信及-sudo-规则) 自动配置主机间互信。 | ||
| 2. `process_supervision` 变量请与之前版本保持一致，默认推荐使用 `systemd`。 | ||
| ``` | ||
| # process supervision, [systemd, supervise] | ||
| process_supervision = systemd | ||
| ``` | ||
| 如需变更，可参考 [如何调整进程监管方式从 supervise 到 systemd](../op-guide/ansible-deployment.md#如何调整进程监管方式从-supervise-到-systemd)，先使用备份 `/home/tidb/tidb-ansible-bak/` 分支变更进程监管方式再升级。 | ||
| ### 编辑 TiDB 集群组件配置文件 | ||
| 如之前自定义过 TiDB 集群组件配置文件，请参照备份文件修改 `/home/tidb/tidb-ansible/conf` 下对应配置文件。 | ||
| TiKV 配置中 `end-point-concurrency` 变更为 `high-concurrency`、`normal-concurrency` 和 `low-concurrency` 三个参数： | ||
| ``` | ||
| readpool: | ||
| coprocessor: | ||
| # Notice: if CPU_NUM > 8, default thread pool size for coprocessors | ||
| # will be set to CPU_NUM * 0.8. | ||
| # high-concurrency: 8 | ||
| # normal-concurrency: 8 | ||
| # low-concurrency: 8 | ||
| ``` | ||
| 单机多 TiKV 实例情况下，需要修改这三个参数，推荐设置：`实例数 * 参数值 = CPU 核数 * 0.8`。 | ||
| ## 下载 TiDB 2.1 binary 到中控机 | ||
| 确认 `tidb-ansible/inventory.ini` 文件中 `tidb_version = v2.1.0`，然后执行以下命令下载 TiDB 2.1 binary 到中控机。 | ||
| ``` | ||
| $ ansible-playbook local_prepare.yml | ||
| ``` | ||
| ## 滚动升级 TiDB 集群组件 | ||
| ``` | ||
| $ ansible-playbook rolling_update.yml | ||
| ``` | ||
| ## 滚动升级 TiDB 监控组件 | ||
| 1. 滚动升级 TiDB 监控组件： | ||
| ``` | ||
| $ ansible-playbook rolling_update_monitor.yml | ||
| ``` |
Oops, something went wrong.