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

Atualizar um autônomo para a versão 7.0

Nesta página

  • Recomendações de upgrade e listas de verificação
  • Pré-requisitos
  • Download 7.0 Binários
  • Procedimento de atualização
  • Procedimentos de atualização adicionais

Use este tutorial para atualizar do MongoDB 6.0 para o MongoDB 7.0. Para atualizar para uma nova versão de patch dentro da mesma série de lançamentos, consulte Atualizar para a versão de patch autogerenciada mais recente do MongoDB.

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

As seguintes etapas esboçam o procedimento para atualizar um autônomo mongod da versão 6.0 para 7.0.

Se você precisar de orientação sobre como atualizar para a versão 7.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 7.0, você deve estar executando uma versão da série 6.0.

Para atualizar de uma versão anterior à série 6.0, é preciso atualizar sucessivamente as principais versões até fazer o upgrade para a série 6.0. Por exemplo, se estiver executando a série 5.0, você deve atualizar para a 6.0 antes de fazer o upgrade para 7.0.

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

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

Antes de iniciar sua atualização, consulte o documento Alterações de compatibilidade no MongoDB 7.0 para garantir que seus aplicativos e sistemas sejam compatíveis com o MongoDB 7.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.

A partir do MongoDB 7.0, você não pode fazer downgrade da versão binária do seu lançamento sem assistência do suporte.

Para saber mais, consulte Downgrade 7.0 para 6.0.

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

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

A operação retorna um documento com a versão de compatibilidade de recursos atual:

{ featureCompatibilityVersion : { version : "6.0" }, ok: 1}

Para definir ou atualizar featureCompatibilityVersion para 6.0, execute o seguinte comando:

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

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, deverá atualizar para a versão 7.0 utilizando seu gerenciador de pacotes.

Siga as instruções de instalação do 7.0 apropriado 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 real.

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 da versão 7.0 para obter mais informações.

1

Para encerrar o processo do mongod, utilize o mongosh para se conectar à instância e executar o seguinte comando:

db.adminCommand( { shutdown: 1 } )
2

Certifique-se de que os binários da série 6.0 estão em seu PATH do sistema. Para confirmar sua versão binária, execute o seguinte comando:

mongod --version

A saída do comando indica uma versão da série 6.0.

3

Neste ponto, você pode executar o 7.0 binários sem os recursos recursos do 7.0 que são incompatíveis com 6.0.

Para habilitar esses recursos da versão 7.0, defina a versão de compatibilidade do recurso (fCV) como 7.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: "7.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.

Voltar

Atualizar de 6.0 para 7.0