diff --git a/README.md b/README.md index b2c261a65ebb..d7b780ba90b7 100755 --- a/README.md +++ b/README.md @@ -78,7 +78,7 @@ + 部署集群 - [Ansible 部署方案(强烈推荐)](op-guide/ansible-deployment.md) - [离线 Ansible 部署方案](op-guide/offline-ansible-deployment.md) - - [从 TiDB 1.0 升级到 2.0 操作指南](op-guide/upgrade-from-v1-to-v2.md) + - [从 TiDB 1.0 升级到 2.0 操作指南](op-guide/tidb-v2-upgrade-guide.md) - [Docker 部署方案](op-guide/docker-deployment.md) - [Docker Compose 部署方案](op-guide/docker-compose.md) - [跨机房部署方案](op-guide/location-awareness.md) diff --git a/op-guide/op-guide.md b/op-guide/op-guide.md index d81c761cde3c..514e94886259 100644 --- a/op-guide/op-guide.md +++ b/op-guide/op-guide.md @@ -13,7 +13,7 @@ category: deployment - [Ansible 部署方案 (强烈推荐)](ansible-deployment.md) - [离线 Ansible 部署方案](offline-ansible-deployment.md) -- [从 TiDB 1.0 升级到 2.0 操作指南](upgrade-from-v1-to-v2.md) +- [从 TiDB 1.0 升级到 2.0 操作指南](tidb-v2-upgrade-guide.md) - [Docker 部署方案](docker-deployment.md) - [跨机房部署方案](location-awareness.md) diff --git a/op-guide/upgrade-from-v1-to-v2.md b/op-guide/tidb-v2-upgrade-guide.md similarity index 75% rename from op-guide/upgrade-from-v1-to-v2.md rename to op-guide/tidb-v2-upgrade-guide.md index 67fe671be855..6239a8107caf 100644 --- a/op-guide/upgrade-from-v1-to-v2.md +++ b/op-guide/tidb-v2-upgrade-guide.md @@ -1,9 +1,11 @@ --- -title: 从 TiDB 1.0 升级到 2.0 操作指南 +title: TiDB 2.0 升级操作指南 category: deployment --- -# 从 TiDB 1.0 升级到 2.0 操作指南 +# TiDB 2.0 升级操作指南 + +> 本文档适用于从 TiDB 1.0 版本或 TiDB 2.0 rc 版本升级到 TiDB 2.0 GA 版本。 ## 在中控机器上安装 Ansible 及其依赖 @@ -22,11 +24,13 @@ Name: jmespath Version: 0.9.0 ``` +> 请务必按以上文档安装 Ansible 及其依赖。确认 Jinja2 版本是否正确,否则启动 Grafana 时会报错。确认 jmespath 版本是否正确,否则滚动升级 TiKV 时会报错。 + ## 在中控机器上下载 TiDB-Ansible 以 `tidb` 用户登录中控机并进入 `/home/tidb` 目录 -备份 tidb-ansible release-1.0 分支文件夹: +备份 TiDB 1.0 版本或 TiDB 2.0 rc 版本的 tidb-ansible 文件夹: ``` $ mv tidb-ansible tidb-ansible-bak @@ -43,6 +47,7 @@ $ git clone -b release-2.0 https://github.com/pingcap/tidb-ansible.git 以 `tidb` 用户登录中控机并进入 `/home/tidb/tidb-ansible` 目录。 ### 编辑 `inventory.ini` 文件 + 编辑 `inventory.ini` 文件,IP 信息参照备份文件 `/home/tidb/tidb-ansible-bak/inventory.ini`。 以下变量配置,需要重点确认,变量含义可参考 [inventory.ini 变量调整](https://github.com/pingcap/docs-cn/blob/master/op-guide/ansible-deployment.md#其他变量调整)。 @@ -67,6 +72,7 @@ $ git clone -b release-2.0 https://github.com/pingcap/tidb-ansible.git 如需变更,可参考 [如何调整进程监管方式从 supervise 到 systemd](https://github.com/pingcap/docs-cn/blob/master/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` 三个参数: @@ -81,11 +87,11 @@ $ git clone -b release-2.0 https://github.com/pingcap/tidb-ansible.git # low-concurrency: 8 ``` - > 单机多 TiKV 实例情况下,需要修改这三个参数,推荐设置:实例数*参数值 = CPU_Vcores * 0.8。 + > 单机多 TiKV 实例情况下,需要修改这三个参数,推荐设置:实例数*参数值 = CPU_Vcores * 0.8 。 ## 下载 TiDB 2.0 binary 到中控机 -确认 `tidb-ansible/inventory.ini` 文件中 `tidb_version = v2.0.0`, 然后执行以下命令下载 TiDB 2.0 binary 到中控机。 +确认 `tidb-ansible/inventory.ini` 文件中 `tidb_version = v2.0.0`, 然后执行以下命令下载 TiDB 2.0 binary 到中控机。 ``` $ ansible-playbook local_prepare.yml @@ -99,23 +105,23 @@ $ ansible-playbook rolling_update.yml ## 滚动升级 TiDB 监控组件 -为满足客户监控组件混布需求,监控组件 systemd service 开始按端口区分。 +1. 为满足客户监控组件混布需求,监控组件 systemd service 开始按端口区分。 -查看 `inventory.ini` 文件中 `process_supervision` 变量: + 查看 `inventory.ini` 文件中 `process_supervision` 变量: -``` -# process supervision, [systemd, supervise] -process_supervision = systemd -``` + ``` + # process supervision, [systemd, supervise] + process_supervision = systemd + ``` -如果 `process_supervision = systemd`, 为兼容之前的版本,你需要执行 `migrate_monitor.yml` Playbook。 + 如果 `process_supervision = systemd`, 为兼容 `v2.0.0-rc.6` 之前的版本,你需要执行 `migrate_monitor.yml` Playbook。如果 `process_supervision = supervise`,此步骤不需要执行。 -``` -$ ansible-playbook migrate_monitor.yml -``` + ``` + $ ansible-playbook migrate_monitor.yml + ``` -滚动升级 TiDB 监控组件: +2. 滚动升级 TiDB 监控组件: -``` -$ ansible-playbook rolling_update_monitor.yml -``` + ``` + $ ansible-playbook rolling_update_monitor.yml + ```