Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ / /

Downgrade 5.0 autônomo para 4.4

Nesta página

  • Caminho de downgrade
  • Criar cópia de segurança
  • Controle de acesso
  • Pré-requisitos
  • Procedimento

Antes de tentar qualquer downgrade, familiarize-se com o conteúdo deste documento.

Se você precisar fazer o downgrade do 5.0, faça o downgrade para a versão de correção mais recente do 4.4.

O MongoDB suporta apenas downgrades de versão única. Você não pode fazer o downgrade para uma versão que esteja várias versões atrás da versão atual.

Por exemplo, você pode desatualizar uma série 5.0 para uma série 4.4. No entanto, não há suporte para desatualização adicional dessa implantação série 4.4 para uma implantação série 4.2.

Opcional, mas recomendado. Crie uma cópia de segurança do seu banco de dados.

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.

Para reduzir de 5.0 para 4.4, você deve remover feições incompatíveis que são persistentes e/ou atualizar configurações incompatíveis. Esses incluem:

O MongoDB 5.0 alterou o valor padrão para read concern e write concern em todo o cluster, e o downgrade para o MongoDB 4.4 pode alterar esses padrões novamente. Considere configurar manualmente o read concern e write concern do seu cluster antes de fazer o downgrade:

  • Para configurar manualmente um valor padrão para um write concern ou write concern do cluster, utilize o comando setDefaultRWConcern.

  • Se seu cluster inclui um árbitro e você já havia desativado a preocupação "Majority" read para evitar a pressão do cache em determinadas situações, convém configurar --enableMajorityReadConcern false ou replication.enableMajorityReadConcern: false depois de fazer o downgrade.

O MongoDB 5.0 adiciona suporte para incluir os caracteres . ou $ nos nomes de campo do documento. Você deve excluir todos os documentos que contenham nomes de campos que incluam os caracteres . ou $ antes de fazer o downgrade para o MongoDB 4.4.

O MongoDB 5.0 permite suporte para arquivos de dados de fuso horário em formato compacto. Se estiver usando arquivos de dados de fuso horário de formato fino em seu sistema, conforme fornecido ao MongoDB com a opção de linha de comando --timeZoneInfo ou a configuração de arquivo de configuração processManagement.timeZoneInfo, será necessário fazer downgrade para o MongoDB 4.4.7 ou posterior, ou então reverter seus arquivos de dados de fuso horário para usar os arquivos de dados anteriores sem formato fino.

Para fazer downgrade do featureCompatibilityVersion do seu autônomo:

  1. Conecte uma shell do mongo à instância do mongod.

  2. Faça o downgrade de featureCompatibilityVersion para "4.4".

    db.adminCommand({setFeatureCompatibilityVersion: "4.4"})

    O comando setFeatureCompatibilityVersion executa grava em uma coleção de sistema interno e é idempotente. Se, por qualquer motivo, o comando não for concluído com êxito, tente novamente o comando na instânciamongod.

As etapas a seguir serão necessárias somente se fCV tiver sido definido como "5.0".

Remova todas as feições do 5.0 persistentes que são incompatíveis com 4.4. Esses incluem:

Coleção de Séries Temporais
Remova todas as coleções de séries temporais.
Gerenciamento de filtros de auditoria em tempo de execução
  • Desative o Gerenciamento de Filtros de Auditoria do Runtime definindo auditLog.runtimeConfiguration como false no arquivo de configuração do nó.

  • Atualize os filtros de auditoria para esta instância no arquivo de configuração local.

Remova todas as feições persistentes que utilizam feições do 5.0. Isso inclui, mas não está limitado a:

Aviso

Antes de prosseguir com o procedimento de downgrade, certifique-se de que os pré-requisitos foram concluídos.

1

Utilizando um gerenciador de pacotes ou um download manual, obtenha a versão mais recente na série 4.4. Se estiver usando um gerenciador de pacotes, adicione um novo repositório para os binários 4.4 e execute o processo de downgrade real.

Importante

Antes de atualizar ou fazer downgrade de um conjunto de réplicas, certifique-se de que todos os membros do conjunto de réplicas estejam em execução. Se você não fizer isso, a atualização ou downgrade não será concluído até que todos os membros sejam iniciados.

Se você precisar fazer o downgrade do 5.0, faça o downgrade para a versão de correção mais recente do 4.4.

2

Para encerrar o processo mongod forma limpa, conecte mongosh à instância e execute:

db.adminCommand( { shutdown: 1 } )

Um desligamento limpo de um mongod conclui todas as operações pendentes, transfere todos os dados para arquivos de dados e fecha todos os arquivos de dados.

3

Desative quaisquer feições configuráveis do 5.0 atualizando o arquivo de configuração da instância do mongod antes de reiniciar.

4

Substitua o binário 5.0 pelo binário 4.4 mongod baixado e reinicie.

Voltar

Faça o downgrade de 5.0 para 4.4