DM 版本升级

本文档主要介绍各 DM (Data Migration) 版本间的升级操作步骤。

注意：

• 若无特殊说明，各版本的升级操作均为从前一个有升级指引的版本向当前版本升级。
• 若无特殊说明，各升级操作示例均假定已经下载了对应版本的 DM 和 DM-Ansible 且 DM binary 存在于 DM-Ansible 的相应目录中（下载 DM binary 可以参考更新组件版本）。
• 若无特殊说明，各升级操作示例均假定升级前已停止所有同步任务，升级完成后手动重新启动所有同步任务。
• 以下版本升级指引逆序展示。

升级到 v1.0.3

版本信息

Release Version: v1.0.3
Git Commit Hash: 41426af6cffcff9a325697a3bdebeadc9baa8aa6
Git Branch: release-1.0
UTC Build Time: 2019-12-13 07:04:53
Go Version: go version go1.13 linux/amd64

主要变更

• dmctl 支持命令式使用
• 支持同步 ALTER DATABASE DDL 语句
• 优化 DM 错误提示信息
• 修复全量导入模块在暂停或退出时 data race 导致 panic 的问题
• 修复对下游进行重试操作时，stop-task 和 pause-task 可能不生效的问题

升级操作示例

1. 下载新版本 DM-Ansible，确认 inventory.ini 文件中 dm_version = v1.0.3
2. 执行 ansible-playbook local_prepare.yml 下载新的 DM binary 到本地
3. 执行 ansible-playbook rolling_update.yml 滚动升级 DM 集群组件
4. 执行 ansible-playbook rolling_update_monitor.yml 滚动升级 DM 监控组件

注意：

更新至 DM 1.0.3 版本时，需要确保 DM 所有组件 (dmctl/DM-master/DM-worker) 同时升级。不支持部分组件升级使用。

升级到 v1.0.2

版本信息

Release Version: v1.0.2
Git Commit Hash: affc6546c0d9810b0630e85502d60ed5c800bf25
Git Branch: release-1.0
UTC Build Time: 2019-10-30 05:08:50
Go Version: go version go1.12 linux/amd64

主要变更

• 支持自动为 DM-worker 生成部分配置项，减少人工配置成本
• 支持自动生成 mydumper 库表参数，减少人工配置成本
• 优化 query-status 默认输出，突出重点信息
• 直接管理到下游的 DB 连接而不是使用内置连接池，优化 SQL 错误处理与重试
• 修复 DM-worker 进程启动时、执行 DML 失败时可能 panic 的 bug
• 修复执行 sharding DDL（如 ADD INDEX）超时后可能造成后续 sharding DDL 无法正确协调的 bug
• 修复了有部分 DM-worker 不可访问时无法 start-task 的 bug
• 完善了对 1105 错误的自动重试策略

升级操作示例

1. 下载新版本 DM-Ansible, 确认 inventory.ini 文件中 dm_version = v1.0.2
2. 执行 ansible-playbook local_prepare.yml 下载新的 DM binary 到本地
3. 执行 ansible-playbook rolling_update.yml 滚动升级 DM 集群组件
4. 执行 ansible-playbook rolling_update_monitor.yml 滚动升级 DM 监控组件

注意：

更新至 DM 1.0.2 版本时，需要确保 DM 所有组件 (dmctl/DM-master/DM-worker) 同时升级。不支持部分组件升级使用。

升级到 v1.0.1

版本信息

Release Version: v1.0.1
Git Commit Hash: e63c6cdebea0edcf2ef8c91d84cff4aaa5fc2df7
Git Branch: release-1.0
UTC Build Time: 2019-09-10 06:15:05
Go Version: go version go1.12 linux/amd64

主要变更

• 修复某些情况下 DM 会频繁重建数据库连接的问题
• 修复使用 query-status 时潜在的 panic 问题

升级操作示例

1. 下载新版本 DM-Ansible, 确认 inventory.ini 文件中 dm_version = v1.0.1
2. 执行 ansible-playbook local_prepare.yml 下载新的 DM binary 到本地
3. 执行 ansible-playbook rolling_update.yml 滚动升级 DM 集群组件
4. 执行 ansible-playbook rolling_update_monitor.yml 滚动升级 DM 监控组件

注意：

更新至 DM 1.0.1 版本时，需要确保 DM 所有组件 (dmctl/DM-master/DM-worker) 同时升级。不支持部分组件升级使用。

升级到 v1.0.0-10-geb2889c9 (1.0 GA)

版本信息

Release Version: v1.0.0-10-geb2889c9
Git Commit Hash: eb2889c9dcfbff6653be9c8720a32998b4627db9
Git Branch: release-1.0
UTC Build Time: 2019-09-06 03:18:48
Go Version: go version go1.12 linux/amd64

主要变更

• 常见的异常场景支持自动尝试恢复同步任务
• 提升 DDL 语法兼容性
• 修复上游数据库连接异常时可能丢失数据的 bug

升级操作示例

1. 下载新版本 DM-Ansible, 确认 inventory.ini 文件中 dm_version = v1.0.0
2. 执行 ansible-playbook local_prepare.yml 下载新的 DM binary 到本地
3. 执行 ansible-playbook rolling_update.yml 滚动升级 DM 集群组件
4. 执行 ansible-playbook rolling_update_monitor.yml 滚动升级 DM 监控组件

注意：

更新至 DM 1.0 GA 版本时，需要确保 DM 所有组件 (dmctl/DM-master/DM-worker) 同时升级。不支持部分组件升级使用。

升级到 v1.0.0-rc.1-12-gaa39ff9

版本信息

Release Version: v1.0.0-rc.1-12-gaa39ff9
Git Commit Hash: aa39ff981dfb3e8c0fa4180127246b253604cc34
Git Branch: dm-master
UTC Build Time: 2019-07-24 02:26:08
Go Version: go version go1.11.2 linux/amd64

主要变更

从此版本开始，将对所有的配置进行严格检查，遇到无法识别的配置会报错，以确保用户始终准确地了解自己的配置。

升级操作示例

启动 DM-master 或 DM-worker 前，必须确保已经删除废弃的配置信息，且没有多余的配置项，否则会启动失败。可根据失败信息删除多余的配置。 可能遗留的废弃配置：

• dm-worker.toml 中的 meta-file
• task.yaml 中的 mysql-instances 中的 server-id