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

Atualize para a versão de patch autogerenciada mais recente do MongoDB

Nesta página

  • Sobre esta tarefa
  • Antes de começar
  • Backup.
  • Considerações de compatibilidade
  • Janela de manutenção
  • Verificação do ambiente de preparo
  • Passos
  • Atualizar uma instância do MongoDB
  • Atualizar conjuntos de réplicas
  • Atualizar clusters fragmentados
  • Saiba mais

Os números de versão do MongoDB têm o formato X.Y.Z, onde Z se refere ao número da versão do patch. Os lançamentos de patches fornecem patches de segurança, correções de erros e recursos novos ou alterados que geralmente não contêm nenhuma alteração retroativa. Sempre atualize para a versão de patch mais recente em sua série de lançamentos.

Para mais informações sobre versionamento, consulte Versionamento do MongoDB.

Esta página descreve os procedimentos de atualização para a série de lançamento do MongoDB 7.0. Para atualizar uma série de versões diferentes, consulte a versão correspondente do manual.

Revise as seguintes seções para garantir que sua implantação esteja pronta para ser atualizada.

Verifique se você tem um backup atualizado do seu conjunto de dados. Consulte Métodos de backup para um sistema autogerenciado.

Consulte os documentos a seguir para considerações especiais ou problemas de compatibilidade específicos de sua versão do MongoDB:

  • Notas de versão

  • Documentação do driver

Se a sua instalação incluir conjuntos de réplicas, defina o upgrade para ocorrer durante uma janela de manutenção predefinida.

Antes de atualizar um ambiente de produção, use os procedimentos deste documento para atualizar um ambiente de preparo que reproduz seu ambiente de produção. Certifique-se de que sua configuração de produção seja compatível com todas as alterações antes de atualizar.

Atualize cada mongod e mongos binário separadamente. Siga este procedimento de atualização:

  1. Para implantações que usam autenticação, primeiro faça upgrade de todos os seus drivers do MongoDB. Para fazer upgrade, consulte a documentação do driver.

  2. Faça upgrade de quaisquer instâncias autônomas. Consulte Faça upgrade de uma instância do MongoDB.

  3. Atualize quaisquer conjuntos de réplicas que não façam parte de um cluster fragmentado, conforme descrito em Atualização de conjuntos de réplicas.

  4. Atualize clusters fragmentados, conforme descrito em Fazer upgrade de clusters fragmentados.

Para atualizar uma instância mongod 7.0 ou mongos, use uma destas abordagens:

  • Atualize a instância usando a ferramenta de gerenciamento de pacotes do sistema operacional e os pacotes oficiais do MongoDB. Essa é a abordagem preferencial. Consulte Instale o MongoDB.

  • Atualize a instância substituindo os binários existentes por novos binários. Consulte Substitua os binários existentes.

Esta seção descreve como atualizar o MongoDB substituindo os binários existentes. A abordagem preferencial para uma atualização é usar a ferramenta de gerenciamento de pacotes do sistema operacional e os pacotes oficiais do MongoDB, conforme descrito em Instale o MongoDB.

Para atualizar uma instância do mongod ou mongos substituindo os binários existentes:

  1. Baixe os binários para a versão de patch mais recente do MongoDB na página de download do MongoDB e armazene os binários em um local temporário. Os binários são baixados como arquivos compactados que descompactam na estrutura de diretórios usada pela instalação do MongoDB.

  2. Desligue a instância.

  3. Substitua os binários MongoDB existentes pelos binários baixados.

  4. Faça as alterações necessárias no arquivo de configuração.

  5. Reinicie a instância.

Para atualizar um conjunto de réplicas 7.0, atualize cada membro individualmente, começando com os secundários e terminando com o primário. Planeje a atualização durante uma janela de manutenção predefinida.

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.

Faça o upgrade de cada secundário separadamente da seguinte forma:

  1. Atualize o binário do secundário mongod seguindo as instruções em Atualize uma instância MongoDB.

  2. Depois de atualizar um secundário, aguarde até que o secundário se recupere para o estado SECONDARY antes de atualizar a próxima instância. Para verificar o estado do membro, emita rs.status() em mongosh.

    O secundário pode entrar brevemente em STARTUP2 ou RECOVERING. Isso é normal. Certifique-se de aguardar até que o secundário se recupere totalmente para SECONDARY antes de continuar a atualização.

  1. Reduza o primário para iniciar o procedimento de failover normal. Usando uma das seguintes opções:

    Durante o failover, o conjunto não pode aceitar gravações. Normalmente, isso leva de 10 a 20 segundos. Planeje a atualização durante uma janela de manutenção predefinida.

    Observação

    É preferível reduzir o primário do que desligá-lo diretamente. A saída agiliza o procedimento de failover.

  2. Depois que o primário for reduzido, chame o método rs.status() de mongosh até que você veja que outro membro assumiu o estado PRIMARY.

  3. Desligue o primário original e atualize sua instância seguindo as instruções em Fazer upgrade de uma instância do MongoDB.

Para atualizar um cluster fragmentado 7.0:

  1. Desative o balanceador do cluster conforme descrito em Desabilite o balanceador.

  2. Atualize os servidores de configuração.

    Para atualizar o conjunto de réplicas do servidor de configuração, use os procedimentos descritos em Atualize os conjuntos de réplicas.

  3. Atualize cada fragmento.

  4. Após os servidores de configuração e os fragmentos terem sido atualizados, atualize cada instância do mongos seguindo as instruções na página Atualizar uma instância do MongoDB. É possível atualizar as instâncias do mongos em qualquer ordem.

  5. Reative o balanceador, conforme descrito em Ative o balanceador.

Voltar

Configuração do Banco de Dados em Tempo de Execução