Importante
MongoDB 8.3 é a versão menor mais recente. A partir do MongoDB 8.2, versões secundárias estão disponíveis para implantações locais (Community e EA) para casos de uso específicos. Para mais informações, consulte Versão do MongoDB.
Para instalar a versão mais recente do MongoDB compatível com uso local, consulte as instruções de instalação.
Antes de tentar fazer um downgrade, familiarize-se com o conteúdo nesta página.
Caminho de downgrade
Se você precisar fazer o downgrade do 8.3, faça o downgrade para a versão de correção mais recente do 8.2.
O MongoDB suporta downgrades de versão única apenas em versões adjacentes. Você não pode fazer o downgrade para uma versão que esteja várias versões atrás da versão atual.
Para qualquer versão, principal ou secundária, você pode atualizar ou fazer downgrade para seus vizinhos adjacentes. Por exemplo, você pode fazer downgrade de 8.3 para 8.2 ou atualizar de 7.0 para 8.0.
Para todas as versões, principais ou secundárias, você pode fazer downgrade para a versão principal imediatamente anterior. Por exemplo, de 8.3 a 8.0.
Para qualquer versão secundária, você pode atualizar para a versão imediatamente seguinte. Por exemplo, de 8.2 a 8.3.
Controle de acesso
Se seu sistema tiver o controle de acesso ativado, os privilégios de usuário de downgrade deverão incluir privilégios para listar e gerenciar índices nos bancos de dados. Um usuário com papel do root tem os privilégios exigidos.
Pré-requisitos
Antes de iniciar o procedimento de downgrade, você deve concluir as etapas de pré-requisito a seguir.
Criar cópia de segurança
Opcional, mas recomendado. Crie uma cópia de segurança do seu banco de dados.
Para saber como criar uma cópia de segurança, consulte Métodos de cópia de segurança para um sistema autogerenciado.
Remover recursos incompatíveis do Backward-Incompatible
Para garantir um downgrade bem-sucedido, remova quaisquer 8.3 recursos que sejam incompatíveis 8.2 com. Para obter uma lista de recursos incompatíveis e como removê-los, consulte Considerações sobre downgrade.
Downgrade Feature Compatibility Version (fCV)
Para fazer downgrade do featureCompatibilityVersion de sua instância standalone:
Faça o downgrade de
featureCompatibilityVersionpara"8.2".Importante
Verifique se você removeu todas as funcionalidades incompatíveis com versões anteriores antes de fazer o downgrade da versão binária. Certifique-se de avaliar o caminho da atualização antes de continuar.
db.adminCommand( { setFeatureCompatibilityVersion: "8.2", confirm: true } ) O comando
setFeatureCompatibilityVersionexecuta gravações em uma coleção interna do sistema e é idempotente. Se o comando não for concluído com êxito, tente novamente o comando na instânciamongod.
Procedimento de downgrade
Aviso
Antes de prosseguir com o procedimento de downgrade, certifique-se de que os pré-requisitos foram concluídos.
Atualizar arquivos de configuração
Desative quaisquer feições configuráveis 8.3 atualizando o mongod arquivo de configuração da instância do antes de reiniciar.
Para visualizar a lista de 8.3 feições do configuráveis, revise as 8.3 Notas de versão do.
Reinicie com a 8.2 mongod instância mais recente
Para iniciar um processo do mongod, execute o seguinte comando:
mongod --dbpath </path-to-data-folder>
Para saber mais sobre como iniciar um processo do mongod, veja Iniciar processos do mongod.