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 2.0 autenticação OAuth, crie uma conta de serviço para usar em suas solicitações para a API pública do Cloud Manager .
Você pode migrar ao vivo as implantações de origem monitoradas pelo Cloud Manager executando o MongoDB 6.0.17+ ou 7.0.13+ para o Atlas. Para saber mais, consulte Migração de produção do seu cluster do MongoDB monitorado pelo Cloud Manager para o Atlas. Para implantações de origem que executam o MongoDB anterior a 6.0.17, você pode usar essas opções de migração legado .
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ções live (push) de implantações de origem do MongoDB que você adiciona ao monitoramento no Cloud Manager, onde o host de migração executa o mongomirror:
ArquiteturaDistro/OS5.0x86_64
RHEL/CentOS 7
RHEL/Centos 8
Amazon Linux 2
SUSE12
SUSE15
Debian 9
Debian 10
Debian 11
Ubuntu 18.x
Ubuntu 20.x
BRAÇO
RHEL/Centos 8
Amazon Linux 2
PowerPC/ ppc64le
RHEL/ Centos 7
RHEL/ Centos 8
zSeries/ 390x
RHEL 7
RHEL 8
Windows
Observaçã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.17+ ou {+c2c-version+7}+ implantações de origem monitoradas 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.
Para o host de migração que executa
mongosyncpara facilitar as migrações push live, use uma instância com um mínimo de 8 CPUs e 24 GB de RAM.Para o host de migração que executa
mongomirrorpara facilitar as migrações push live, use um host com 2a4 núcleos de CPU e 4a8 GB de RAM para migrar um conjunto de réplicas. Use uma instância com 2a4 núcleos de CPU por fragmento para migrar um cluster fragmentado.
Procedimento
No MongoDB Cloud Manager, acesse aGo 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.
Acesse a página Agents.
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.