DM バイナリを使用したデータ移行のデプロイ

このドキュメントでは、DM バイナリを使用してデータ移行 (DM) クラスターを迅速にデプロイする方法を紹介します。

注記：
本番環境では、 TiUPを使用してDMクラスタを展開する推奨されます。

DMバイナリをダウンロード

DM バイナリはTiDB Toolkitに含まれています。TiDBTiDB Toolkitをダウンロードするには、 TiDBツールをダウンロード参照してください。

サンプルシナリオ

次のサンプルシナリオに基づいて DM クラスターを展開するとします。

2 つの DM ワーカーノードと 3 つの DM マスターノードが 5 台のサーバーに展開されます。

各ノードのアドレスは次のとおりです。

実例	サーバーアドレス	ポート
DMマスター1	192.168.0.4	8261
DMマスター2	192.168.0.5	8261
DMマスター3	192.168.0.6	8261
DMワーカー1	192.168.0.7	8262
DMワーカー2	192.168.0.8	8262

このシナリオに基づいて、次のセクションでは DM クラスターを展開する方法について説明します。

注記：
単一のサーバーに複数の DM マスターまたは DM ワーカーインスタンスを展開する場合、各インスタンスのポートと作業ディレクトリは一意である必要があります。
DM クラスターの高可用性を確保する必要がない場合は、DM マスターノードを 1 つだけデプロイし、デプロイされた DM ワーカーノードの数は、移行するアップストリーム MySQL/MariaDB インスタンスの数以上である必要があります。
DM クラスターの高可用性を確保するには、3 つの DM マスターノードを展開することをお勧めします。また、展開された DM ワーカーノードの数は、移行するアップストリーム MySQL/MariaDB インスタンスの数より多くする必要があります (たとえば、DM ワーカーノードの数は、アップストリームインスタンスの数より 2 つ多くなります)。
次のコンポーネント間のポートが相互接続されていることを確認します。
DM マスターノード間の8291ポートは相互接続されています。
各 DM マスターノードは、すべての DM ワーカーノードの8262ポートに接続できます。
各 DM ワーカーノードは、すべての DM マスターノードの8261ポートに接続できます。

DMマスターをデプロイ

コマンドラインパラメータまたは設定ファイルを使用して DM マスターを構成できます。

DMマスターのコマンドラインパラメータ

DM マスターのコマンドラインパラメータの説明は次のとおりです。

./dm-master --help

Usage of dm-master:
  -L string
        log level: debug, info, warn, error, fatal (default "info")
  -V    prints version and exit
  -advertise-addr string
        advertise address for client traffic (default "${master-addr}")
  -advertise-peer-urls string
        advertise URLs for peer traffic (default "${peer-urls}")
  -config string
        path to config file
  -data-dir string
        path to the data directory (default "default.${name}")
  -initial-cluster string
        initial cluster configuration for bootstrapping, e.g. dm-master=http://127.0.0.1:8291
  -join string
        join to an existing cluster (usage: cluster's "${master-addr}" list, e.g. "127.0.0.1:8261,127.0.0.1:18261"
  -log-file string
        log file path
  -master-addr string
        master API server and status addr
  -name string
        human-readable name for this DM-master member
  -peer-urls string
        URLs for peer traffic (default "http://127.0.0.1:8291")
  -print-sample-config
        print sample config file of dm-worker

注記：
状況によっては、一部の構成がコマンドラインに公開されていないため、上記の方法を使用して DM-master を構成できない場合があります。そのような場合は、代わりに構成ファイルを使用します。

DMマスター構成ファイル

以下は DM-master の設定ファイルです。この方法で DM-master を設定することをお勧めします。

次の設定をconf/dm-master1.tomlに書き込みます。

# Master Configuration.
name = "master1"

# Log configurations.
log-level = "info"
log-file = "dm-master.log"

# The listening address of DM-master.
master-addr = "192.168.0.4:8261"

# The peer URLs of DM-master.
peer-urls = "192.168.0.4:8291"

# The value of `initial-cluster` is the combination of the `advertise-peer-urls` value of all DM-master nodes in the initial cluster.
initial-cluster = "master1=http://192.168.0.4:8291,master2=http://192.168.0.5:8291,master3=http://192.168.0.6:8291"

DM-master を実行するには、ターミナルで次のコマンドを実行します。
```
./dm-master -config conf/dm-master1.toml
```
注記：
このコマンドを実行した後、コンソールはログを出力しません。ランタイムログを表示する場合は、 tail -f dm-master.log実行してください。
DM-master2 と DM-master3 については、設定ファイルのnameそれぞれmaster2とmaster3に変更し、 peer-urlsそれぞれ192.168.0.5:8291と192.168.0.6:8291に変更します。次に、手順 2 を繰り返します。

DMワーカーをデプロイ

コマンドラインパラメータまたは設定ファイルを使用して DM-worker を構成できます。

DM-worker コマンドラインパラメータ

DM-worker コマンドラインパラメータの説明は次のとおりです。

./dm-worker --help

Usage of worker:
  -L string
        log level: debug, info, warn, error, fatal (default "info")
  -V    prints version and exit
  -advertise-addr string
        advertise address for client traffic (default "${worker-addr}")
  -config string
        path to config file
  -join string
        join to an existing cluster (usage: dm-master cluster's "${master-addr}")
  -keepalive-ttl int
        dm-worker's TTL for keepalive with etcd (in seconds) (default 10)
  -log-file string
        log file path
  -name string
        human-readable name for DM-worker member
  -print-sample-config
        print sample config file of dm-worker
  -worker-addr string
        listen address for client traffic

注記：
状況によっては、一部の構成がコマンドラインに公開されていないため、上記の方法を使用して DM-worker を構成することはできません。そのような場合は、代わりに構成ファイルを使用します。

DMワーカー設定ファイル

以下は DM-worker 設定ファイルです。この方法を使用して DM-worker を設定することをお勧めします。

次の設定をconf/dm-worker1.tomlに書き込みます。

# Worker Configuration.
name = "worker1"

# Log configuration.
log-level = "info"
log-file = "dm-worker.log"

# DM-worker address.
worker-addr = ":8262"

# The master-addr configuration of the DM-master nodes in the cluster.
join = "192.168.0.4:8261,192.168.0.5:8261,192.168.0.6:8261"

DM-worker を実行するには、ターミナルで次のコマンドを実行します。
```
./dm-worker -config conf/dm-worker1.toml
```
DM-worker2 の場合、設定ファイルのname worker2に変更します。次に、手順 2 を繰り返します。

これで、DM クラスターが正常にデプロイされました。