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

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

注記:

本番環境では、 TiUP を使用して DM クラスターをデプロイするを推奨します。

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

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

サンプルシナリオ

このサンプル シナリオに基づいて DM クラスターをデプロイするとします。

2 つの DM ワーカー ノードと 3 つの DM マスター ノードが 5 つのサーバーにデプロイされます。

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

実例サーバーアドレスポート
DMマスター1192.168.0.48261
DMマスター2192.168.0.58261
DMマスター3192.168.0.68261
DM-ワーカー1192.168.0.78262
DM-worker2192.168.0.88262

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

注記:

  • 複数の DM マスター インスタンスまたは DM ワーカー インスタンスを 1 つのサーバーにデプロイする場合、各インスタンスのポートと作業ディレクトリは一意である必要があります。

  • 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 マスターを構成することができません。このような場合は、代わりに構成ファイルを使用してください。

DMマスター設定ファイル

以下はDM-masterの設定ファイルです。この方法を使用して DM マスターを構成することをお勧めします。

  1. 次の設定を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"
  2. ターミナルで次のコマンドを実行して、DM-master を実行します。

    ./dm-master -config conf/dm-master1.toml

    注記:

    このコマンド実行後、コンソールにはログが出力されません。実行時ログを表示したい場合は、 tail -f dm-master.logを実行します。

  3. DM-master2 と DM-master3 の場合、設定ファイルのnameそれぞれmaster2master3に変更し、 peer-urlsそれぞれ192.168.0.5:8291192.168.0.6:8291に変更します。その後、ステップ 2 を繰り返します。

DM ワーカーをデプロイ

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

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 ワーカーを構成することができません。このような場合は、代わりに構成ファイルを使用してください。

DM ワーカー設定ファイル

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

  1. 次の設定を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"
  2. ターミナルで次のコマンドを実行して、DM-worker を実行します。

    ./dm-worker -config conf/dm-worker1.toml
  3. DM-worker2 の場合、構成ファイルのname worker2に変更します。その後、ステップ 2 を繰り返します。

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

このページは役に立ちましたか?