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

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"
            },
         "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 はソースへの書込みをブロックします。

• enableUserWriteBlocking を "none" に設定して mongosync を起動する場合は、書込みが無効になっていることを確認します。例、ソースクラスターで setUserWriteBlockMode コマンドを実行します。

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

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

に commit mongosyncリクエストを送信します。

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

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

{"success":true}

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

progressエンドポイントを呼び出して、 canWriteがtrueであるかどうかを確認します。 canWriteがfalseの場合は、 progressがcanWriteがtrueであることを示すまで待ちます。

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

true

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

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

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

setUserWriteBlockMode を使用して宛先クラスターでの書込みを手動でブロックした場合は、宛先クラスターでアプリケーション書込みを有効にします。

書込みを有効にするには、 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"