Data Migration Configuration File Overview

This document gives an overview of configuration files of DM (Data Migration).

DM process configuration files

inventory.ini: The configuration file of deploying DM using DM-Ansible. You need to edit it based on your machine topology. For details, see Edit the inventory.ini file to orchestrate the DM cluster.
dm-master.toml: The configuration file of running the DM-master process, including the topology information of the DM cluster and the corresponding relationship between the MySQL instance and DM-worker (must be one-to-one relationship). When you use DM-Ansible to deploy DM, dm-master.toml is generated automatically.
dm-worker.toml: The configuration file of running the DM-worker process, including the upstream MySQL instance configuration and the relay log configuration. When you use DM-Ansible to deploy DM, dm-worker.toml is generated automatically.

When you use DM-Ansible to deploy DM, you can find the following task configuration file template in <path-to-dm-ansible>/conf:

task.yaml.exmaple: The standard configuration file of the data replication task (a specific task corresponds to a task.yaml). For the introduction of the configuration file, see Task Configuration File.

You can perform the following steps to create a data replication task based on task.yaml.example:

Copy task.yaml.example as your_task.yaml.
Refer to the description in the Task Configuration File and modify the configuration in your_task.yaml.
Create your data replication task using dmctl.

This section shows description of some important concepts.

Concept	Description	Configuration File
`source-id`	Uniquely identifies a MySQL or MariaDB instance, or a replication group with the master-slave structure.	`source_id` of `inventory.ini`; `source-id` of `dm-master.toml`; `source-id` of `task.yaml`
DM-worker ID	Uniquely identifies a DM-worker (by the `worker-addr` parameter of `dm-worker.toml`)	`worker-addr` of `dm-worker.toml`; the `-worker`/`-w` flag of the dmctl command line