カットオーバー プロセスの終了

mongosync のステータスを確認します。

カットオーバー プロセスを開始する前に、プログレスエンドポイントを呼び出して、 mongosyncのステータスを判断します。 mongosyncプロセス ステータスが次の値を示していることを確認します。

• canCommit は true です。

• lagTimeSeconds は小さい値（ 0に近い値）です。

  カットオーバーの開始時にlagTimeSecondsが0に近くない場合、カットオーバーに長い時間がかかる可能性があります。

• verification.source埋め込み検証子を使用する場合は、verification.destination と が返すドキュメントの両方を確認します。両方のドキュメントの lagTimeSeconds フィールドは 0 に近く、phase フィールドには "stream hashing" が表示される必要があります。

  検証子がストリーム ハッシュ フェーズにない場合、カットオーバー プロセスに長い時間がかかる可能性があります。

次の例では、同期プロセスのステータスを返します。

curl localhost:27182/api/v1/progress -XGET

{
   "progress":
      {
         "state":"RUNNING",
         "canCommit":true,
         "canWrite":false,
         "info":"change event application",
         "lagTimeSeconds":0,
         "collectionCopy":
            {
               "estimatedTotalBytes":694,
               "estimatedCopiedBytes":694
            },
         "directionMapping":
            {
               "Source":"cluster0: localhost:27017",
               "Destination":"cluster1: localhost:27018"
            },
         "source":
            {
               "pingLatencyMs":250
            },
         "destination":
            {
               "pingLatencyMs":-1
            },
         "verification":
            {
               "source":
                  {
                     "estimatedDocumentCount": 42,
                     "hashedDocumentCount": 42,
                     "lagTimeSeconds": 2,
                     "totalCollectionCount": 42,
                     "scannedCollectionCount": 10,
                     "phase": "stream hashing"
                  },
               "destination": {
                     "estimatedDocumentCount": 42,
                     "hashedDocumentCount": 42,
                     "lagTimeSeconds": 2,
                     "totalCollectionCount": 42,
                     "scannedCollectionCount": 10,
                     "phase": "stream hashing"
               }
            }
      },
   "success": true
}

ソース上の同期されたコレクションへの書込み操作を停止します。

• ソースクラスター上のすべてのトランザクションがコミットまたは中止されるまで待機します。

• mongosync はデフォルトで 宛先のみの書込みブロックを有効にします。 enableUserWriteBlocking を "destinationOnly" に設定して mongosync を起動することで、明示的に有効にすることができます。 mongosync は宛先への書込みのみをブロックし、canWrite が true に設定される 直前 にブロックを解除します。

• enableUserWriteBlocking を "sourceAndDestination" に設定して mongosync を起動すると、mongosync は宛先クラスターのすべての書込み操作のブロックを解除し、canWrite が true に設定される直前にブロックを解除します。 /commit を呼び出した後、mongosync はソースへの書込みをブロックします。

• If you start mongosync with enableUserWriteBlocking set to "none", ensure that you disable writes. For example, run the setUserWriteBlockMode command on the source cluster:

  db.adminCommand( {
      setUserWriteBlockMode: 1,
      global: true 
  } )

• mongosync がフィルタリングされた同期を使用する場合、ソースクラスター全体への書込みを無効にする必要はありません。 ただし、フィルターに含まれるコレクションの書込み (write) 操作は、必ず停止する必要があります。

Send a commit request to mongosync.

移行のために複数の mongosync インスタンスを起動する場合は、mongosyncインスタンスごとにコミットリクエストを発行する必要があります。

curl localhost:27182/api/v1/commit -XPOST --data '{ }'

{"success":true}

宛先クラスターで書込み (write) を実行できるまで待ちます。

progress エンドポイントとなる接続されたデバイスを呼び出して、canWrite が true であるかどうかを確認します。canWrite が false の場合は、progress が canWrite が true であることを示すまで待ちます。複数の mongosync インスタンス を実行中いる場合は、最初の mongosync プロセスで canWrite が true であることのみを確認してください。後続の mongosync プロセスの canWrite ステータスが無効です。

curl -sS localhost:27182/api/v1/progress -XGET | jq ".progress.canWrite"

true

データ転送を確認します。

ソースクラスターから宛先クラスターへのデータの同期が成功したことを確認します。

詳細については、「データ転送を確認する 」を参照してください。

If you manually blocked writes on the destination cluster by using setUserWriteBlockMode, enable application writes on the destination cluster.

To enable writes, update setUserWriteBlockMode:

db.adminCommand(
   {
      setUserWriteBlockMode: 1,
      global: false
   }
)

その後、アプリケーションワークロードを宛先クラスターに転送します。

mongosyncenableUserWriteBlocking/start エンドポイントで オプションを使用して書込みブロックで を起動した場合は、この手順を完了する必要はありません。

progress エンドポイントとなる接続されたデバイスを呼び出して、mongosync プロセスのステータスを確認します。

mongosync進行状況応答がmongosync状態がCOMMITTEDであることを示している場合、カットオーバー プロセスは完了します。

curl -sS localhost:27182/api/v1/progress -XGET | jq ".progress.state"

"COMMITTED"