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

Atualizar um autônomo para a versão 5.0

Nesta página

  • Recomendações de upgrade e listas de verificação
  • Pré-requisitos
  • Baixar binários 5.0
  • Processo de atualização
  • Procedimentos de atualização adicionais

Familiarize-se com o conteúdo deste documento, incluindo a revisão minuciosa dos pré-requisitos, antes de atualizar para MongoDB 5.0.

As etapas a seguir descrevem o procedimento para atualizar um mongod autônomo da versão 4.4 para o 5.0.

Se você precisar de orientação sobre como atualizar para a versão 5.0, os serviços profissionais do MongoDB oferecem suporte de atualização da versão principal para ajudar a garantir uma transição tranquila, sem interrupção para seu aplicativo MongoDB.

Ao atualizar, considere o seguinte:

Para atualizar uma implantação MongoDB existente para 5,0, você deve estar executando uma versão da série 4,4.

Para atualizar de uma versão anterior à série 4.4, você deve atualizar sucessivamente as principais versões até que você tenha atualizado para a série 4.4. Por exemplo, se estiver executando uma série 4.2, você deverá atualizar primeiro para 4.4 antes de atualizar para 5.0.

Antes de fazer upgrade do MongoDB, verifique se você está usando um driver compatível com o MongoDB 5.0. Consulte a documentação do driver para seu driver específico para verificar a compatibilidade com o MongoDB 5.0.

As implementações atualizadas que são executadas em drivers incompatíveis podem encontrar comportamentos inesperados ou indefinidos.

Aviso

Se seus drivers usam opcodes legados que foram preteridos na v3.6, atualize seus drivers para uma versão que use opcodes compatíveis. Drivers que usam opcodes legados não são mais suportados.

Antes de iniciar sua atualização, consulte o documento Alterações de compatibilidade no MongoDB 5.0 para garantir que seus aplicativos e implantações sejam compatíveis com o MongoDB 5.0. Resolva as incompatibilidades em sua implantação antes de iniciar a atualização.

Antes de atualizar o MongoDB, sempre teste seu aplicativo em um ambiente de preparação antes de implantar a atualização em seu ambiente de produção.

Depois de atualizado para 5.0, se você precisar fazer o downgrade, recomendamos fazer o downgrade para a versão de patch mais recente do 4.4.

Antes de atualizar seu autônomo para a versão 5.0 mongod, consulte as considerações de desempenho da versão 5.0 para identificar possíveis impactos na performance.

Verifique se a configuração de TTL é válida. Antes de atualizar, remova ou corrija quaisquer índices TTL que tenham o expireAfterSeconds configurado para NaN. No MongoDB 5.0 e posterior, a configuração expireAfterSeconds para NaN tem o mesmo efeito que a configuração expireAfterSeconds para 0. Para obter detalhes, consulte Comportamento do expireAfterSeconds TTL quando definido como NaN.

Antes de fazer o upgrade, confirme se a instância mongod foi desligada de forma limpa.

A instância 4.4 deve ter featureCompatibilityVersion definido como "4.4". Para verificar featureCompatibilityVersion:

db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )

A operação deve retornar um resultado que inclua "featureCompatibilityVersion" : { "version" : "4.4" }.

Para configurar ou atualizar o featureCompatibilityVersion, execute o seguinte comando:

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

Para mais informações, consulte setFeatureCompatibilityVersion.

Antes de atualizar, considere converter sua implantação independente em um conjunto de réplicas. Os conjuntos de réplicas são a configuração de implantação recomendada para MongoDB.

Se você instalou o MongoDB a partir dos repositórios MongoDB apt, yum, dnf ou zypper, deve atualizar para a versão 5.0 usando o gerenciador de pacotes.

Siga as instruções de instalação do 5.0 apropriadas para seu sistema Linux. Isso envolverá a adição de um repositório para a nova versão e, em seguida, a execução do processo de atualização atual.

Se você não tiver instalado o MongoDB usando um gerenciador de pacotes, poderá fazer o download manual dos binários do MongoDB no MongoDB Download Center.

Consulte as instruções de instalação do 5.0 para mais informações.

Aviso

Se você atualizar uma instância existente do MongoDB para o MongoDB 5.0.15, essa instância poderá falhar ao iniciar se fork: true estiver definido no arquivo mongod.conf .

O problema de atualização afeta todas as instâncias MongoDB que utilizam pacotes de instalação do .deb ou .rpm . As instalações que usam a versão tarball (.tgz) ou outros tipos de pacote não são afetadas. Para obter mais informações, consulte SERVER-74345.

Para remover a configuração fork: true , execute estes comandos a partir de um terminal do sistema:

systemctl stop mongod.service
sed -i.bak '/fork: true/d' /etc/mongod.conf
systemctl start mongod.service

O segundo comando systemctl inicia a instância atualizada após a configuração ser removida.

1

Desligue sua instância do mongod. Substitua o binário existente pelo binário 5.0 mongod.

Reinicie seu sistema com o 5.0 mongod.

2

Neste ponto, você pode executar os binários do 5.0 sem as feições do 5,0 que são incompatíveis com 4.4.

Para habilitar essas funcionalidades do 5.0, defina feature compatibility version (FCV) para 5.0.

Dica

Habilitar essas recursos funcionalidades com versões anteriores pode complicar o processo de downgrade, pois você deve remover todos as funcionalidades persistentes incompatíveis com versões anteriores antes de fazer o downgrade.

É recomendável que, após a atualização, você permita que seu sistema seja executado sem habilitar essas funcionalidades por um período de burn-in para garantir que a probabilidade de downgrade seja mínima. Quando você estiver confiante de que a probabilidade de downgrade é mínima, habilite essas funcionalidades.

Execute o comando setFeatureCompatibilityVersion no banco de dados do admin :

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

Este comando deve executar gravações em uma collection interna do sistema. Se, por algum motivo, o comando não for concluído com êxito, você poderá tentar novamente com segurança, pois a operação é idempotente.

Observação

Após a conclusão da atualização, você poderá encontrar um aumento significativo nos tamanhos dos índices. Para visualizar os tamanhos dos índices, consulte dbStats.indexSize. O aumento do tamanho do índice se deve aos dados relacionados à janela de tempo armazenados nas chaves do índice.

Se seus índices forem significativamente maiores após a atualização e você quiser reduzir os tamanhos dos índices, entre em contato com seu representante de suporte técnico do MongoDB para discutir soluções.

Voltar

Atualizar 4.4 para 5.0