在线应用 Hotfix 到 DM 集群

    • 将用于替换的二进制包上传到目标机器
    • 通过 API 下线节点
    • 停止目标服务
    • 解压二进制包，替换服务
    • 启动目标服务
    • <cluster-name> 代表要操作的集群名。
    • <package-path> 为用于替换的二进制包。

    执行 tiup dm patch 命令前，需要进行以下操作准备用于替换的二进制包：

    • 确定当前要替换的组件名称 ${component} (dm-master，dm-worker 等) 以及其版本 ${version} (v2.0.0，v2.0.1 等)，以及其运行的平台 ${os} (linux) 和 ${arch} (amd64, arm64)
    • 下载当前的组件包：wget https://tiup-mirrors.pingcap.com/${component}-${version}-${os}-${arch}.tar.gz -O /tmp/${component}-${version}-${os}-${arch}.tar.gz
    • 建立临时打包目录：mkdir -p /tmp/package && cd /tmp/package
    • 解压原来的二进制包：tar xf /tmp/${component}-${version}-${os}-${arch}.tar.gz
    • 查看临时打包目录中的文件结构：find .
    • 将要替换的二进制文件或配置文件复制到临时目录的对应位置
    • 重新打包 tar czf /tmp/${component}-hotfix-${os}-${arch}.tar.gz *

    完成以上操作后，/tmp/${component}-hotfix-${os}-${arch}.tar.gz 就可以作为 <package-path> 用于 patch 命令中。

    --overwrite

    • 对某个组件（比如 TiDB，TiKV）进行 patch 之后，该集群扩容该组件时，tiup-dm 默认会用原来的版本。如果希望后续扩容的时候也使用 patch 之后的版本的话，就需要指定 --overwrite 选项。
    • 数据类型：BOOLEAN

    指定要替换的节点，该选项的值为以逗号分割的节点 ID 列表，节点 ID 为表格的第一列。

    注意

    若同时指定了 -R, --role，那么将替换它们的交集中的服务。

    -R, —role（strings，默认为 []，未选中任何角色）

    指定要替换的角色，该选项的值为以逗号分割的节点角色列表，角色为表格的第二列。

    在线应用 Hotfix 到 DM 集群 - 图2

    若同时指定了 -N, --node，那么将替换它们的交集中的服务。

    声明当前集群处于离线状态。指定该选项时，TiUP DM 仅原地替换集群组件的二进制文件，不重启服务。

    -h, —help

    • 输出帮助信息。
    • 数据类型：BOOLEAN
    • 该选项默认关闭，默认值为 false。在命令中添加该选项，并传入 true 值或不传值，均可开启此功能。

    以下将在使用 TiUP 部署的 DM 环境中演示如何应用 v5.3.0-hotfix 到 v5.3.0集群，其他部署方式可能需要调整部分操作。

    注意

    Hotfix 仅用于紧急修复，其日常维护较为复杂，建议在正式版本发布后及时升级。

    在开始应用 Hotfix 之前，请准备好 Hotfix 补丁包 ，并确认当前环境 DM 软件版本：

    1. /home/tidb/dm/deploy/dm-master-8261/bin/dm-master/dm-master -V

    输出示例：

    1. Release Version: v5.3.0
    2. Git Commit Hash: 20626babf21fc381d4364646c40dd84598533d66
    3. Git Branch: heads/refs/tags/v5.3.0
    4. UTC Build Time: 2021-11-29 08:29:49
    5. Go Version: go version go1.16.4 linux/amd64

    制作 Patch 补丁包并应用到 DM 集群

      1. mkdir -p /tmp/package
      2. tar -zxvf /root/.tiup/storage/dm/packages/dm-master-v5.3.0-linux-amd64.tar.gz -C /tmp/package/
      3. tar -zxvf /root/.tiup/storage/dm/packages/dm-worker-v5.3.0-linux-amd64.tar.gz -C /tmp/package/

    2. 替换新的二进制文件：

    3. 应用补丁。

      查询当前集群状态，以名称为 dm-test 的集群为例：

      1. tiup dm display dm-test

      输出示例：

      1. Cluster type:       dm
      2. Cluster name:       dm-test
      3. Cluster version:    v5.3.0
      4. Deploy user:        tidb
      5. SSH type:           builtin
      6. ID                  Role                 Host           Ports      OS/Arch       Status     Data Dir                              Deploy Dir
      7. --                  ----                 ----           -----      -------       ------     --------                              ----------
      8. 172.16.100.21:9093  alertmanager         172.16.100.21  9093/9094  linux/x86_64  Up         /home/tidb/dm/data/alertmanager-9093  /home/tidb/dm/deploy/alertmanager-9093
      9. 172.16.100.21:8261  dm-master            172.16.100.21  8261/8291  linux/x86_64  Healthy|L  /home/tidb/dm/data/dm-master-8261     /home/tidb/dm/deploy/dm-master-8261
      10. 172.16.100.21:8262  dm-worker            172.16.100.21  8262       linux/x86_64  Free       /home/tidb/dm/data/dm-worker-8262     /home/tidb/dm/deploy/dm-worker-8262
      11. 172.16.100.21:3000  grafana              172.16.100.21  3000       linux/x86_64  Up         -                                     /home/tidb/dm/deploy/grafana-3000
      12. Total nodes: 5

      将补丁应用到指定节点或指定角色，若同时使用 -R 和 ，将会取其交集。

      1. # 为指定节点应用补丁
      2. tiup dm patch dm-test dm-master-hotfix-linux-amd64.tar.gz -N 172.16.100.21:8261
      3. tiup dm patch dm-test dm-worker-hotfix-linux-amd64.tar.gz -N 172.16.100.21:8262
      5. # 为指定角色应用补丁
      6. tiup dm patch dm-test dm-master-hotfix-linux-amd64.tar.gz -R dm-master
      7. tiup dm patch dm-test dm-worker-hotfix-linux-amd64.tar.gz -R dm-worker

    4. 查看补丁应用结果：

      输出示例：

      1. Release Version: v5.3.0-20211230
      2. Git Commit Hash: ca7070c45013c24d34bd9c1e936071253451d707
      3. Git Branch: heads/refs/tags/v5.3.0-20211230
      4. UTC Build Time: 2022-01-05 14:19:02
      5. Go Version: go version go1.16.4 linux/amd64

      集群信息也会有所变化：

      1. tiup dm display dm-test
      1. Starting component `dm`: /root/.tiup/components/dm/v1.8.1/tiup-dm display dm-test
      2. Cluster type:       dm
      3. Cluster name:       dm-test
      4. Cluster version:    v5.3.0
      5. Deploy user:        tidb
      6. SSH type:           builtin
      7. ID                  Role                 Host           Ports      OS/Arch       Status     Data Dir                              Deploy Dir
      8. --                  ----                 ----           -----      -------       ------     --------                              ----------
      9. 172.16.100.21:9093  alertmanager         172.16.100.21  9093/9094  linux/x86_64  Up         /home/tidb/dm/data/alertmanager-9093  /home/tidb/dm/deploy/alertmanager-9093
      10. 172.16.100.21:8261  dm-master (patched)  172.16.100.21  8261/8291  linux/x86_64  Healthy|L  /home/tidb/dm/data/dm-master-8261     /home/tidb/dm/deploy/dm-master-8261
      11. 172.16.100.21:8262  dm-worker (patched)  172.16.100.21  8262       linux/x86_64  Free       /home/tidb/dm/data/dm-worker-8262     /home/tidb/dm/deploy/dm-worker-8262
      12. 172.16.100.21:3000  grafana              172.16.100.21  3000       linux/x86_64  Up         -                                     /home/tidb/dm/deploy/grafana-3000
      13. Total nodes: 5