Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/ / /

Solucionar problemas de migração live (pull)

Nesta página

  • Erros comuns de validação de migração em produção (pull)
  • Erros comuns de pós-validação

Antes de iniciar o processo demigração ao vivo (pull) do , o Atlas realiza uma verificação de validação para garantir que todos os campos e parâmetros do formulário necessários estejam funcionais e corretos. Se algum parâmetro for inválido, o Atlas retornará um erro e a migração ao vivo não continuará.

Esta seção descreve erros comuns de validação de migração ao vivo (pull) e fornece sugestões sobre o que verificar se você os encontrar.

Erro
Correção
Não foi possível acessar a origem especificada
  • Certifique-se de que adicionou os intervalos de sub-rede corretos à lista de acesso IP no cluster de origem. Você pode encontrar os quatro intervalos de sub-rede necessários na janela modal de migração em produção.

  • Confirme se o nome de host que você especificou resolve para um endereço IP público. Em um prompt de comando, use um dos seguintes comandos:

    nslookup <hostname>
    ping <hostname>
  • Certifique-se de não estar usando uma VPC Peering, que não é compatível com a migração em produção. Se uma conexão de Peering VPC for sua única opção, use o mongomirror .

Não foi possível resolver o nome do host
Nenhum endereço IP foi encontrado para o nome de host fornecido. Confirme se o nome de host fornecido está correto e acessível publicamente.
Opções SSL inválidas fornecidas

Se você estiver usando SSL:

  • Confirme se o certificado SSL está completo e copiado corretamente para a janela modal de migração em produção (pull).

  • Confirme se o interruptor de alternância Is encryption in transit enabled? está na posição Yes .

Se você não estiver usando SSL:

  • Verifique sua string de conexão e confirme se o parâmetro de query ssl não está presente. Se o --ssl fizer parte da sua string de conexão, seu cluster exigirá uma conexão SSL.

  • Confirme se o interruptor de alternância Is encryption in transit enabled? está na posição No .

O nome de usuário ou senha não está correto

Confirme suas credenciais no mongosh com os seguintes comandos:

use admin
db.getUser("<username>");

Se o problema persistir, atualize a senha do usuário MongoDB.

Usuário não autorizado a executar o comando
Para executar o processo de migração em produção (pull), o usuário do MongoDB deve ter privilégio de sistema suficientes. Para saber mais, consulte Segurança do cluster de origem.
Informações de armazenamento em disco indisponíveis
Para executar o processo de migração em produção (pull), o usuário do MongoDB deve ter permissões na instância do MongoDB do cluster de origem. Para saber mais, consulte Segurança do cluster de origem.
O uso do disco de origem é muito grande para o destino
Diferentes camadas de serviço do Atlas têm diferentes quantidades de espaço em disco disponível. Certifique-se de que seu Atlas cluster tenha espaço em disco suficiente para todos os dados em seu cluster de origem. Para saber mais sobre dimensionamentos de cluster, consulte Criar um Novo Cluster.
A fonte parece ser autônomo
Seu sistema de origem deve ser um conjunto de réplicas MongoDB. Se seu sistema de origem for atualmente um nó standalone, converta-o em um conjunto de réplicas de nó único antes de executar a migração live (pull).
Não foi possível processar o arquivo CA fornecido
Confirme se o arquivo CA está completo e colado corretamente na janela modal de migração live (pull).
Erro
Correção
Não foi possível recuperar a última entrada do oplog da origem: não encontrado
  • Se a origem for um conjunto de réplicas, verifique se você tem acesso de leitura no banco de dados local.

  • Se a origem for uma instância autônoma, converta-a em um conjunto de réplicas antes de prosseguir com a migração.

  • Confirme que o cluster de origem tem um oplog legível.

  • Se você ainda não conseguir acessar o oplog, use o mongorestore em vez disso para importar seus dados para o Atlas.

Não foi possível determinar se --host é um conjunto de réplicas: erro ao conectar ao servidor de banco de dados: nenhum servidor acessível
  • Certifique-se de ter adicionado todos os endereços IP que o serviço de migração em produção (pull) exige à lista de acesso IP do cluster de origem.

  • Confirme se o endereço IP ou o nome de host DNS que você forneceu é resolvido para um endereço IP acessível publicamente.

Erro ao aplicar entradas de oplog durante a sincronização inicial: o comando renameCollection foi encontrado durante a sincronização inicial. Reinicie mongomirror.

Renaming uma collection no cluster de origem durante a migração em produção (pull) pode trigger esse erro.

  • Certifique-se de que nenhum usuário ou aplicação renomeie nenhuma collection enquanto a migração em produção (pull) estiver ocorrendo.

  • Operações de agregação que usam $out podem trigger esse erro. Certifique-se de que nenhuma operação $out ocorra durante o procedimento de migração live (pull).

Erro de índice não suportado
Determinados tipos e configurações de índices que eram permitidos em versões anteriores do MongoDB não são mais suportados em versões mais recentes. Verifique as notas de versão da versão MongoDB em seu cluster de destino para possíveis conflitos. Se necessário, elimine quaisquer índices que causem erros e reconstrua-os após a conclusão do processo de migração em produção.
Erro ao seguir o oplog na origem: o checkpoint não está disponível no oplog

A migração live (pull) usa o oplog de origem para sincronizar as operações que ocorrem no cluster de origem durante o procedimento de migração live live. Se o tamanho do oplog do cluster de origem for muito pequeno, talvez ele não consiga registrar todas as operações que ocorrem no cluster de origem durante a sincronização, e a migração live (pull) fica muito atrasada para recuperar o atraso.

Se você vir este erro:

  • Verifique o tamanho do oplog do cluster de origem usando o comando rs.printReplicationInfo() . O servidor que está hospedando o mongomirror deve ter espaço em disco disponível suficiente para conter os dados de oplog gerados durante o processo de migração.

  • Se necessário, aumente o tamanho do oplog de origem para permitir uma janela de replicação longa o suficiente para concluir o procedimento de migração live.

  • Se o erro ocorrer ao executar mongomirror diretamente, reinicie mongomirror usando --oplogPath para armazenar em buffer os dados do oplog em disco durante a migração.