Finalize o processo de transição

Verifique o status do mongosync.

Ligue para o endpoint de progresso para determinar o status de mongosync antes de iniciar o processo de cutover. Certifique-se de que o status do processo mongosync indique os seguintes valores:

• canCommit é true.

• lagTimeSeconds é pequeno (perto de 0).

  Se lagTimeSeconds não estiver próximo de 0 quando a transição começar, a transição poderá levar muito tempo.

• Ao usar o Verificador incorporado, verifique verification.source os verification.destination documentos de devolução e. Os campos lagTimeSeconds em ambos os documentos devem estar próximos de 0 e os campos phase devem mostrar "stream hashing".

  Se o verificador não estiver na fase de hash de fluxo, o processo de corte pode levar muito tempo.

O exemplo a seguir retorna o status do processo de sincronização.

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
}

Pare todas as operações de gravação nas coleções sincronizadas na origem.

• Aguarde todas as transações no cluster de origem confirmarem ou cancelarem.

• mongosync habilita o bloqueio de gravação somente de destino por padrão. Você pode habilitá-lo explicitamente começando mongosync com enableUserWriteBlocking configurado para "destinationOnly". mongosync apenas bloqueia gravações no destino e as desbloqueia logo antes de canWrite ser definido como true.

• Se você iniciar mongosync com enableUserWriteBlocking definido como "sourceAndDestination", mongosync bloqueará todas as operações de gravação no cluster de destino e as desbloqueará logo antes de canWrite ser definido como true. mongosync bloqueia gravações na fonte depois de chamar /commit.

• 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 
  } )

• Se o mongosync usar sincronização filtrada, não será necessário desabilitar as gravações em todo o cluster de origem. No entanto, você deve garantir que você interrompa as operações de gravação para as coleções que o filtro inclui.

Envie uma solicitação de confirmação para mongosync.

Se você iniciar múltiplas instâncias do mongosync para sua migração, você deverá emitir uma solicitação de confirmação para cada instância do mongosync.

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

{"success":true}

Aguarde até que você possa executar gravações no cluster de destino.

Chame o ponto de extremidade progress para determinar se canWrite é true. Se canWrite for false, aguarde até que progress mostre que canWrite é true. Se você estiver executando várias instâncias do mongosync, verifique apenas se canWrite é verdadeiro no primeiro processo mongosync. O status canWrite de qualquer processo mongosync subsequente não é válido.

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

true

Verifique a transferência de dados.

Verifique a sincronização bem-sucedida de dados da origem para o cluster de destino.

Para obter mais informações, consulte Verificar a fonte de dados.

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
   }
)

Em seguida, transfira o volume de trabalho do aplicação para o cluster de destino.

Se você iniciou o mongosync com bloqueio de gravação usando a opção enableUserWriteBlocking no endpoint /start, não será necessário concluir esta etapa.

Chame o ponto de extremidade progress para determinar o status do processo mongosync.

Quando a resposta de progresso do mongosync indicar que o estado do mongosync é COMMITTED, o processo de cutover estará concluído.

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

"COMMITTED"