Provisionar um host de migração para o MongoDB Agent
Nesta página
- A autenticação OAuth 2.0 para acesso programático ao Cloud Manager está disponível como um recurso de visualização.
- O recurso e a documentação correspondente podem mudar a qualquer momento durante o período de Pré-visualização. Para usar a autenticação OAuth 2.0 , crie umaconta de serviço para usar em suas solicitações para a API pública do Cloud Manager .
Importante
Migração em tempo real (push) obsoleta ou sem suporte para implantações de origem gerenciadas ou monitoradas pelo Ops Manager
Para implantações de origem que executam qualquer versão do MongoDB 6.0.+ em que as implantações são gerenciadas ou monitoradas pelo Ops Manager, a migração ao vivo (push) não é suportada.
Para implantações de origem que executam qualquer MongoDB 5.0 e versões anteriores, em que as implantações são gerenciadas ou monitoradas pelo Ops Manager, a migração ao vivo (push) é preterida.
Para implantações de origem com o MongoDB 6.0.+, onde as implantações são monitoradas pelo Cloud Manager, a migração de produção (push) é suportada. Para saber mais, consulte Migração em produção do seu cluster do MongoDB monitorado pelo Cloud Manager para o Atlas.
Para migrar ao vivo sua implantação de origem do MongoDB monitorada no Cloud Manager para o Atlas, provisione um servidor para o host de migração.
Visão geral
O host de migração é um servidor no qual você instala um MongoDB Agent dedicado. Este MongoDB Agent automatiza operações de migração em produção. É necessário que você defina a opção de configuração agentFeatureCloudMigrationEnabled como true.
Você utiliza o host de migração para managed o processo de migração em produção de sua implementação do Cloud Manager para o Atlas. Você não pode usar o host de migração para outros fins.
Após provisionar o host de migração, seu servidor aparece na aba Servers . Um MongoDB Agent no host de migração executa uma migração única de dados do Cloud Manager para o Atlas e relata o status da migração em produção de volta ao Cloud Manager.
Para saber como iniciar uma migração live do Cloud Manager, consulte Migrar uma implementação para o Atlas e revisar o fluxo de trabalho da migração live para o Atlas.
Considerações
Se você planeja migrar mais de um sistema de cada vez, crie um host de migração dedicado para cada um dos sistemas que deseja migrar para o Atlas.
Observação
O uso de um proxy HTTP, que intercepta e substitui certificados TLS para as solicitações HTTPS retransmitidas, não é suportado pelo Ops Manager quando você o utiliza no modo híbrido.
Pré-requisitos
O host de migração deve usar uma arquitetura de CPU de 64 bits e uma das seguintes plataformas suportadas. As plataformas dependem da ferramenta de migração que o host de migração executará para facilitar a migração.
host de migração para migração em produção (push) de implantações de origem do MongoDB versões 5.0+, mas não 6.0 (FCV) que você adiciona ao monitoramento no Cloud Manager, onde o host de migração executa o mongomirror:
ArquiteturaDistro/OS5.0x86_64RHEL/CentOS 7RHEL/Centos 8Amazon Linux 2SUSE12SUSE15Debian 9Debian 10Debian 11Ubuntu 18.xUbuntu 20.xBRAÇORHEL/Centos 8Amazon Linux 2PowerPC/ ppc64leRHEL/ Centos 7RHEL/ Centos 8zSeries/ 390xRHEL 7RHEL 8WindowsObservação
A configuração de um host de migração para migração em produção não é suportada no Windows ou macOS. Você ainda pode migrar (push) seus dados de uma implantação baseada no Windows para o Atlas se provisionar seu host de migração em uma das plataformas suportadas. Você não pode migrar seus dados ao vivo de uma implantação baseada em macOS para o Atlas.
Se o Cloud Manager estiver sendo executado no modo local, você deverá ter acesso de saída ao servidor a seguir para fazer o download do mongomirror.
translators-connectors-releases.s3.amazonaws.com Host de migração para migrações ao vivo (push) do MongoDB 6.0.8+ sistemas de origem monitorados no Cloud Manager, onde o host de migração executa o mongosync:
O host de migração deve usar uma arquitetura de CPU de 64bits e uma das plataformas mongosync.
Requisitos de recursos do host de migração
O processo de migração em produção exige CPU e largura de banda de rede suficiente. Use uma instância de cloud com recursos suficientes para ajudar a garantir uma migração bem-sucedida.
Evite ambientes de host que foramcaracterizados como tendo baixa largura de banda de rede.
Talvez você também precise provisionar armazenamento adicional para a opção cloudMigrationOplogPath descrita no procedimento a seguir.
MongoDB 6.0.8+. Para o host de migração que executa o
mongosyncpara facilitar a migração em produção, use uma instância com um mínimo de 8 CPUs e 24 GB de RAM.Versões 5.0+ do MongoDB, mas não 6.0 (FCV). Para o host de migração que executa o
mongomirrorpara facilitar a migração em produção, use um host com 2 a 4 núcleos de CPU e 4 a 8 GB de RAM para migrar um conjunto de réplicas. Use uma instância com 2 a 4 núcleos de CPU por fragmento para migrar um cluster fragmentado.
Procedimento
No MongoDB Cloud Manager, acesse a Deployment página do seu projeto.
Se ainda não estiver exibido, selecione a organização que contém o projeto desejado no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Se a página Deployment ainda não estiver exibida, clique em Deployment na barra lateral.
A página Sistema é exibida.
Vá para a Agents página .
Clique na aba Agents para sua implantação.
A página Agentes é exibida.
Em Automation, selecione seu sistema operacional e siga as instruções para instalar e executar o agente no host de migração.
Para saber mais, consulte Instale o MongoDB Agent para apenas monitorar ou fazer backup de sistemas.
Edite o arquivo de configuração do MongoDB Agent para habilitar a migração em produção.
Se o arquivo automation-agent.config ainda não estiver aberto na etapa anterior, abra-o no editor de texto de sua preferência:
sudo vi /etc/mongodb-mms/automation-agent.config Adicione ou atualize as seguintes opções de configuração de migração em produção:
ChaveValortrueCaminho para os arquivos oplog do processo de migração live . Essa chave é opcional e, se definida, requer o provisionamento de armazenamento suficiente no diretório especificado para o armazenamento em buffer do oplog . Entre em contato com o suporte do MongoDB se precisar de ajuda para determinar se essa chave é necessária para seu sistema.Certifique-se de que as alterações resultantes no arquivo agente de automação.config contenham as seguintes opções de configuração necessárias para a migração em produção:
mmsGroupId=<The ID of your project> mmsApiKey=<The Agent API key of your project> agentFeatureCloudMigrationEnabled=true cloudMigrationOplogPath=<The path to the oplog files>
Um servidor adicional aparece na guia Servers e um MongoDB Agent adicional aparece na guia Agents .
Próximos passos
Depois de provisionar o host de migração, você pode alternar para o Atlas e seguir as etapas do assistente para iniciar o processo de migração em tempo real.