Migrar ao vivo (Push) um conjunto de réplicas monitorado pelo MongoDB Ops Manager ou Cloud Manager (MongoDB antes de 6.0.17)

No Atlas, acesse a página Organization Settings.

1. Se ainda não estiver exibido, selecione sua organização desejada no Menu Organizations na barra de navegação.

2. Clique no ícone Organization Settings próximo ao menu Organizations.

   A página Configurações da organização é exibida.

Acesse a página Live Migration to Atlas.

Clique em Live Migration na barra lateral.

A página migração em produção para Atlas é exibida.

Inicie o processo de migração.

1. Clique em Migrate from Ops Manager or Cloud Manager.

2. Clique em I'm Ready to Start e, se estiver migrando da MongoDB Community usando o MongoDB Ops Manager, clique em Ops Manager License Agreement para ler e aceitá-la. Para ler o contrato fora do assistente de migração em tempo real, consulte o Contrato de migração doMongoDB Ops Manager .

O Atlas exibe um assistente de migração em produção com instruções sobre como proceder com o processo. O processo envia os dados do cluster de origem para o novo cluster de destino. Depois de concluir as etapas do assistente, você poderá ponto sua aplicação para o novo cluster.

Vincular com o Atlas.

1. Clique Generate Link-Token. O Atlas exibe a página para gerar um link-token.

   • Se você estiver migrando do Ops Manager, insira os endereços IP externos ou um bloco CIDR de suas instâncias do Ops Manager para adicioná-las à lista de acesso da chave API incorporada no link-token. Isto permite ao Ops Manager enviar informações do projeto e cluster para o Atlas. O Ops Manager não envia nenhum dado armazenado em seus reconhecimento de data center MongoDB nesta etapa. Por exemplo, insira 23.248.95.14 .

   • Se você estiver migrando do Cloud Manager, pule esta etapa.

2. Clique em Next para ver uma página que contém o link-token gerado.

3. Copie o link-token e armazene-o em um local seguro. O Atlas nunca exibe o conteúdo do link-token. O Atlas também não exibe o link-token após gerá-lo. Não o compartilhe publicamente.

   Observação

   Use um link-token exclusivo para migrar ao vivo todos os projeto em uma organização do Cloud Manager ou do Ops Manager para o Atlas.

4. Clique em Done.

Cole o link-token no Ops Manager ou Cloud Manager.

1. Acesse a organização no Cloud Manager ou Ops Manager:

   Abra o Ops Manager ou o Cloud Manager e navegue até a organização cujo cluster do projeto você está migrando em tempo real para o Atlas.

2. Clique em Settings no painel de navegação esquerdo.

3. Na seção Live Migration: Connect to Atlas , clique em Connect to Atlas. A caixa de diálogo Connect to Atlas aparece.

4. Cole o link-token gerado na etapa anterior do assistente de Migração em Tempo Real e clique em Connect to Atlas. O Cloud Manager ou o MongoDB Ops Manager estabelece a conexão com o Atlas. Utilize o botão Refresh para enviar uma atualização para Atlas, se necessário. Para saber mais, consulte Conectar ao Atlas para migração live no MongoDB Ops Manager ou Conectar ao Atlas para migração live no Cloud Manager.

Criar o cluster do Atlas de destino.

Caso ainda não tenha feito isso, crie um cluster de destino no Atlas. Consulte Pré-requisitos.

Inicie a migração do cluster de destino.

1. Clique em Select Target Cluster from Projects.

2. Vá para o projeto do seu Atlas cluster de destino e encontre seu cluster de destino.

3. Clique em e selecione Migrate Data to this Cluster na lista suspensa para iniciar a migração. A página Migrate Data to This Cluster abre.

4. Clique em Migrate from Ops Manager or Cloud Manager e preencha os campos da seguinte forma:

   • Selecione o projeto de origem no Cloud Manager ou no Ops Manager, se ainda não estiver selecionado.

   • Selecione um host de migração para lidar com a migração.

   • Revise a lista de acesso ao endereço IP e verifique se o endereço IP externo do host de migração está incluído nessa lista. Se não tiver sido adicionado, adicione-o agora:

     • Clique em Set Network Access for Host

     • Clique em + Add IP Address

     • Retorne ao assistente de migração em produção. Selecione o cluster de origem no menu suspenso e escolha Migrate data to this cluster em .

   • Selecione o cluster de origem no menu suspenso.

   • Se você suspender a automação do cluster de origem no Cloud Manager ou no MongoDB Ops Manager, mas continuar monitorando o cluster de origem com o Monitoring Agent, o Username e o Password serão exibidos. Se o seu sistema exigir autenticação do usuário, forneça o nome de usuário e senha nestes campos. O usuário do banco de dados cujas credenciais você fornece deve ter pelo menos a função de backup no banco de dados admin e deve ser autenticado usando SCRAM-SHA-1 e SCRAM-SHA-256.

   • Se o cluster de origem usar TLS/SSL, alterne o botão Is encryption in transit enabled? .

   • Se o cluster de origem usar TLS/SSL com uma Autoridade de Certificação Raiz personalizada (CA), copie o caminho para o arquivo CA do seu host de migração e cole esse caminho na caixa de texto fornecida. O arquivo deve estar presente no host de migração para garantir que o host de migração possa ler o certificado. O Atlas verifica se o certificado está presente e legível.

   • Se o cluster de destino do conjunto de réplicas tiver dados e você quiser preservá-los, mantenha a opção Clear any existing data on your destination cluster desmarcada. O serviço de migração em produção avisa se encontrar namespace duplicados. Se você deseja excluir os dados existentes, marque esta opção.

   • Escolha uma conexão para se conectar ao cluster. O Standard connection sempre aparece como disponível na interface do usuário. No entanto, outras opções de conexão serão habilitadas somente se você tiver configurado anteriormente uma conexão de emparelhamento de VPC ou um endpoint privado. Se o Atlas detectar que você não tem conexões VPC ou endpoints privados configurados, essas opções ficarão esmaecidas.

     • Se você não estiver usando o VPC Peering ou um endpoint privado, clique em Standard connection e prossiga para o estágio Validation desta etapa.

     • Se você configurou uma conexão de emparelhamento de VPC entre o host de migração e o Atlas cluster, a opção VPC Peering estará ativa. Clique VPC Peering para se conectar usando o emparelhamento VPC para migração live. Se a opção VPC Peering estiver esmaecida, configure uma conexão de emparelhamento VPC antes de iniciar este procedimento. Para saber mais, consulte Suporte para emparelhamento de VPC e endpoints privados.

     • Se você estiver migrando um conjunto de réplicas e configurou um endpoint privado entre o host de migração e o Atlas cluster, a opção Private Endpoint estará ativa. Clique Private Endpoint para se conectar a um endpoint privado e selecione um endpoint privado configurado anteriormente no menu suspenso. Somente endpoints privados que estão em AVAILABLE estado são válidos. Se a opção Private Endpoint estiver acinzentada, configure um endpoint privado antes de iniciar este procedimento. Para saber mais, consulte Suporte para emparelhamento de VPC e endpoints privados.

       Observação

       Endpoints privados são suportados UNICAmente para migração em produção de conjuntos de réplicas distribuídos em um único cloud provider e região. Clusters fragmentados, cluster multirregional e clusters multicloud não suportam migração em produção por meio de endpoints privados.

   • Clique Validate. O processo de validação verifica se o seu host de migração está acessível e realiza as seguintes verificações de validação para garantir que você possa iniciar a migração em produção para o Atlas.

     Para aproveitar as seguintes verificações de validação, atualize o MongoDB Agent no MongoDB Ops Manager ou atualize o MongoDB Agent no Cloud Manager para a versão mais recente. Se o processo de migração live detectar que o cluster de origem está executando uma versão do MongoDB Agent anterior a 12.0.11.7606 para o MongoDB Ops Manager ou 12.5.0.7713 para o Cloud Manager, ele exibe um aviso sugerindo que você atualize o MongoDB Agent.

     As seguintes verificações de validação são executadas durante a migração em produção:

     • O host de migração pode se conectar ao cluster de destino.

     • Se o cluster de origem usar TLS/SSL com uma Autoridade de Certificação Raiz personalizada, o host de migração poderá acessar o cluster de origem usando TLS/SSL.

     • As credenciais do usuário de banco de dados são válidas. Essa verificação de validação é executada somente se você suspender a automação do cluster de origem no Cloud Manager ou no Ops Manager, mas continuar monitorando o cluster de origem com o agente de monitoramento.

     • Se você estiver migrando do MongoDB Ops Manager anterior à versão 5.0.9, o processo de migração live validará se o cluster de destino tem espaço em disco suficiente com base no tamanho dos dados. Se você estiver migrando do Cloud Manager ou do MongoDB Ops Manager 5.0.9 ou posterior, o processo de migração validará que o cluster de destino tem espaço em disco suficiente com base no tamanho de armazenamento dos dados compactados. Para saber mais sobre dados e tamanhos de armazenamento, consulte dbStats.

   • Se a validação falhar, verifique o host de migração, a validade dos seus endereços IP externos ou bloco CIDR e o link-token. Verifique também as credenciais do trigger de banco de dados, seus certificados TLS/SSL e a quantidade de tamanho de armazenamento em disco no reconhecimento de data center de destino.

   • Se a validação for bem-sucedida, clique em Next . A página Migrate from Ops Manager or Cloud Manager é exibida.

Inicie a migração.

1. Revise o relatório que lista a organização de origem, o projeto e o cluster, bem como o host de migração que o processo de migração em produção usará.

2. Clique em Start the Migration.

Prepare-se para o cut over.

Um valor de tempo de atraso é exibido durante a fase final de rejeitos do oplog, que representa o atraso atual entre os clusters de origem e de destino. Esse tempo de atraso pode flutuar dependendo da taxa de geração de oplog no cluster de origem, mas deve diminuir com o tempo à medida que o processo de migração em produção copia as entradas de oplog para o cluster de destino.

1. Quando o temporizador de atraso e o botão Prepare to Cutover se tornarem verdes, clique nele para prosseguir para a próxima etapa.

Execute a transição.

When Atlas detects that the source and destination clusters are nearly in sync, it starts an extendable 120 hour (5 day) timer to begin the cutover stage of the live migration procedure. If the 120 hour period passes, Atlas stops synchronizing with the source cluster. You can extend the time remaining by 24 hours by clicking Extend time below the <time> left to cut over timer.

Se a migração estiver para expirar, o Atlas enviará um e-mail semelhante ao exemplo a seguir:

A migration to your Atlas cluster will expire in <number> hours!
Navigate to your destination cluster to start the cutover process. If
you don't take any action within <number> hours, the migration will be
cancelled and you will need to start again. You can also extend the
migration process if you need more time.

Para concluir a migração dos dados do MongoDB para o cluster do Atlas, conclua as seguintes etapas na página Your migration is almost complete! :

1. Prepare-se para apontar para seu cluster Atlas. Copie a nova connection string para que você possa atualizá-la e aponte seu aplicativo para o Atlas cluster de destino.

2. Pare seu aplicativo. Essa ação garante que não ocorra mais nenhuma gravação no cluster de origem.

3. Aguarde até que a lacuna do optime chegue a zero. Quando o contador chega a zero, os clusters de origem e destino estarão sincronizados.

4. Clique em Cut Over para concluir o processo de migração.

   Se você clicar em Cancel na barra de progresso da migração em produção, o Atlas parará de sincronizar as gravações do cluster de origem. Todos os dados migrados permanecem no seu cluster do Atlas.

   Você pode clicar em Cut Over novamente para permitir que o Atlas conclua o processo de migração.

5. Aguarde até que o Atlas configure seu cluster de destino e ele esteja pronto para uso. Para clusters menores, esse tempo é de 3a5 minutos. Para clusters maiores, esse tempo pode se estender até 10 minutos ou mais, dependendo do tamanho e da configuração do cluster.

   Se o processo de transferência estiver em andamento há pelo menos 12 horas, a Atlas envia um e-mail sugerindo que você verifique o processo de migração ou entre em contato com o suporte.

6. Quando estiver tudo pronto para redirecionar gravações para o cluster de destino no Atlas:

   1. Use a string de conexão do cluster de destino para se conectar ao seu aplicativo.

   2. Confirme que seu aplicativo está funcionando com o cluster de destino do Atlas.

   3. Verifique seus dados no cluster de destino.

   4. Retome as gravações no cluster de destino.

   Atlas executa estas ação para concluir o processo:

   • Remove as sub-redes do servidor de migração ao vivo do MongoDB da lista de acesso IP no cluster de destino.

   • Remover o usuário de banco de dados que a migração em produção usou para importar dados para o cluster de destino.

   • Marca o processo de migração como concluído.