TiDB 2.0 升级操作指南

    TiDB-Ansible release-2.0 版本依赖 Ansible 2.4.2 及以上版本，兼容最新的 Ansible 2.5 版本，另依赖 Python 模块：jinja2>=2.9.6 和 jmespath>=0.9.0。为方便管理依赖，新版本使用 pip 安装 Ansible 及其依赖，可参照在中控机器上安装 Ansible 及其依赖 进行安装。离线环境参照。

    安装完成后，可通过以下命令查看版本：

    在中控机器上下载 TiDB-Ansible

    以 tidb 用户登录中控机并进入 /home/tidb 目录，备份 TiDB 1.0 版本或 TiDB 2.0 rc 版本的 tidb-ansible 文件夹：

      下载最新 tidb-ansible release-2.0 分支，默认的文件夹名称为 tidb-ansible。

      1. $ git clone -b release-2.0 https://github.com/pingcap/tidb-ansible.git

      以 tidb 用户登录中控机并进入 /home/tidb/tidb-ansible 目录。

      以下变量配置，需要重点确认，变量含义可参考 。

      1. 请确认 ansible_user 配置的是普通用户。为统一权限管理，不再支持使用 root 用户远程安装。默认配置中使用 用户作为 SSH 远程用户及程序运行用户。

        可参考如何配置 ssh 互信及 sudo 免密码 自动配置主机间互信。

      2. process_supervision 变量请与之前版本保持一致，默认推荐使用 systemd。

        1.  # process supervision, [systemd, supervise]
        2.  process_supervision = systemd

        如需变更，可参考 ，先使用备份 /home/tidb/tidb-ansible-bak/ 分支变更进程监管方式再升级。

      编辑 TiDB 集群组件配置文件

      如之前自定义过 TiDB 集群组件配置文件，请参照备份文件修改 /home/tidb/tidb-ansible/conf 下对应配置文件。

      1. readpool:
      2.   coprocessor:
      3.     # Notice: if CPU_NUM > 8, default thread pool size for coprocessors
      5.     # normal-concurrency: 8
      6.     # low-concurrency: 8

      单机多 TiKV 实例情况下，需要修改这三个参数，推荐设置：实例数 * 参数值 = CPU 核数 * 0.8。

      下载 TiDB 2.0 binary 到中控机

      确认 tidb-ansible/inventory.ini 文件中 tidb_version = v2.0.4，然后执行以下命令下载 TiDB 2.0 binary 到中控机。

      1. $ ansible-playbook rolling_update.yml

      滚动升级 TiDB 监控组件

      1. 为满足客户监控组件混布需求，监控组件 systemd service 开始按端口区分。

        查看 inventory.ini 文件中 process_supervision 变量：

        1.  # process supervision, [systemd, supervise]
        2.  process_supervision = systemd

        如果 process_supervision = systemd，为兼容 v2.0.0-rc.6 之前的版本，你需要执行 migrate_monitor.yml Playbook。如果 process_supervision = supervise，此步骤不需要执行。

      2. 滚动升级 TiDB 监控组件：