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.
Recomendações de upgrade e listas de verificação
Ao atualizar, considere o seguinte:
Atualizar caminho da versão
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.
Verifique a compatibilidade do driver
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.
Preparação
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.
Consideração de rebaixamento
Você não pode fazer downgrade da versão binária do seu sistema sem assistência do suporte.
Para saber mais, consulte Downgrade 8.0 para 7.0.
Pré-requisitos
Versão de compatibilidade de recursos
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.
Considere converter para conjunto de réplicas
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.
Download 7.0 Binários
Através do Gerenciador de Pacotes
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.
Manualmente
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.
Procedimento de atualização
Habilite recursos 7.0 incompatíveis com versões anteriores.
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 estas funcionalidades do 7.0, configure a versão de compatibilidade do recurso (FCV) para 7.0. Você também deve definir confirm como true se estiver atualizando para 7.0 ou posterior.
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", confirm: true } )
Importante
O MongoDB 7.0 introduz o campo de confirmação. Você deve definir confirmar como true para que o comando seja bem-sucedido.
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.
Procedimentos de atualização adicionais
Para atualizar um conjunto de réplicas, consulte Atualizar um conjunto de réplicas para 7.0.
Para atualizar um cluster fragmentado, consulte Atualizar um cluster fragmentado para 7.0.