Para fazer downgrade do cluster do Atlas Core para a versão principal anterior do MongoDB , você deve ter fixado o FCV antes de atualizar. Este tutorial descreve como fazer downgrade do seu Atlas cluster e como fixar e desafixar o FCV.
Para saber o que é o FCV e como a fixação dele preserva a capacidade de downgrade, consulte Versões do MongoDB e Caminhos de Atualização.
Importante
Os clusters Atlas Infinite não suportam controle manual do MongoDB .
Somente os clusters Atlas Core suportam a atualização e o downgrade de versões do MongoDB .
Os clusters Atlas Infinite executam o MongoDB usando Latest Version With Auto Upgrades e não permitem atualizações de versão manuais. O Atlas gerencia automaticamente o controle de versão para clusters Atlas Infinite.
Limitações
As seguintes limitações se aplicam ao downgrade da versão do seu cluster:
Você só pode fazer downgrade do cluster usando o procedimento nesta página se tiver fixado a versão de compatibilidade do recurso antes da atualização.
Você só pode fazer downgrade do cluster para a versão principal que corresponda ao FCV fixado .
Você só pode executar essa ação se o FCV fixado estiver apenas uma versão principal abaixo do FCV atual e você não tiver Latest Version With Auto Upgrades ativado.
Se o seu cluster usar a Versão mais recente com atualizações automáticas, você não poderá fixar seu FCV e não poderá fazer downgrade do cluster. Se você quiser sair das Atualizações Automáticas, poderá fazê-lo após o lançamento da versão principal (
x.0.0), mas antes da primeira versão secundária desse ciclo (x.1.0).Você não pode fazer downgrade para uma versão depois que ela atingir o fim da vida útil. Certifique-se de que a fixação ocorra antes que a versão atual atinja o fim da vida útil.
A pinagemFCV só está disponível em clusters Dedicados.
A fixação doFCV não pode ser estendida para além de 4 semanas a partir da data da fixação.
Se um downgrade for necessário e você não fixou a versão de compatibilidade do recurso antes de atualizar, você poderá:
Restaurar para um ponto específico no tempo:
Se você tiver o backups em nuvem contínuo ativado para o cluster, poderá executar uma restauração de PIT para restaurar o cluster para um estado anterior com a versão mais antiga do MongoDB:
Criar um novo cluster com a versão principal anterior.
Execute uma restauração do PIT usando as instruções em Restaurar do Backup Contínuo na Nuvem.
Restaurar a partir de um snapshot do Atlas :
Se você tiver o Backup em Nuvem ativado sem backups contínuos na nuvem, considere restaurar o snapshot mais recente do cluster com base na versão anterior para um novo cluster:
Criar um novo cluster com a versão principal anterior.
Restaure o snapshot mais recente antes do upgrade da versão do MongoDB para o novo cluster usando as instruções em restaurar a partir de um snapshot agendado ou sob demanda.
Acesso necessário
Para fazer downgrade de um cluster por uma versão principal, fixar o FCV para seu cluster ou desafixar o FCV para seu cluster, você deve ter a função Project Owner ou superior para o projeto.
Faça downgrade do seu cluster por uma versão principal
Para fazer downgrade do cluster em uma versão principal:
No Atlas, vá para a página Clusters do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto 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.
Na barra lateral, clique em Clusters sob o título Database.
A página Clusters é exibida.
Para fazer downgrade do cluster por uma versão principal usando a API, consulte Modificar um cluster de um projeto.
Pins a versão de compatibilidade do recurso para o seu cluster
Quando o cluster tem um FCV fixado, um ícone de pino aparece ao lado do Version do cluster na parte inferior do cartão do cluster. Se você passar o cursor sobre o ícone de pino, será exibida uma dica de ferramenta que mostra o FCV e a data de expiração.
Atlas unpins your cluster's FCV on the next maintenance window starting on or after the expiration date.
Se você já atualizou a versão MongoDB do seu cluster, o Atlas atualizará seu FCV para corresponder à sua versão MongoDB após o pino expirar.
Aviso
O Pin FCV é uma medida de curto prazo que persiste por até 4 semanas após a data do Pin e não simula o comportamento das versões binárias anteriores. Ele apenas adia a atualização de certas estruturas de dados internas que permitem novos recursos de servidor . Quando estiver confiante de que um downgrade para a versão anterior é desnecessário, desmarque o FCV para corresponder à versão binária atual.
Para fixar o FCV para o seu cluster:
No Atlas, vá para a página Clusters do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto 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.
Na barra lateral, clique em Clusters sob o título Database.
A página Clusters é exibida.
Defina a data de expiração.
Todas as datas são definidas como carimbo de data/hora no formato de data e hora ISO 8601 em UTC, no formato MM/DD/YYYY. Defina a data de expiração do FCV para dentro de quatro semanas da data em que você fixou o FCV. Quando a data de expiração passa,a dica de ferramenta exibe Expired XX/XX/XXXX. Seu pin do FCV expira automaticamente após 4 semanas.
Depois que o pin do FCV expirar, o Atlas desafixará o FCV do seu cluster na próxima período de manutenção a partir da data de expiração ou após a data de expiração. Se você já atualizou a versão MongoDB do seu cluster, o Atlas atualizará seu FCV para corresponder à sua versão MongoDB .
Para fixar a versão de compatibilidade do recurso para seu cluster usando a Atlas Administration API, consulte Pin FCV para um cluster de um projeto.
Retirar a versão de compatibilidade do recurso para o seu cluster
Para desafixar o FCV para o seu cluster:
No Atlas, vá para a página Clusters do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto 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.
Na barra lateral, clique em Clusters sob o título Database.
A página Clusters é exibida.
Para desafixar a versão de compatibilidade do recurso para seu cluster usando a Atlas Administration API, consulte Desafixar a versão de compatibilidade do recurso para um cluster de um projeto.
Entre em contato com o suporte
Se você tiver alguma dúvida sobre o suporte à migração além do que é abordado nesta documentação, ou se encontrar um erro durante a migração, registre um tíquete de suporte por meio da Atlas user interface.
Se tiver alguma dúvida ou precisar de mais ajuda, entre em contato com nossa equipe de suporte.