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 que executa 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 sistemas de origem executando 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) de MongoDB 6.0.17+ ou {+c2c-version+7}+ 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.
Para o host de migração que executa
mongosync
para 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
mongomirror
para facilitar as migrações push live, use um host com 2-4 núcleos de CPU e 4-8 GB de RAM para migrar um conjunto de réplicas. Use uma instância com 2-4 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:
ChaveValortrue
Caminho 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.