Importante
MongoDB 8.3 é a versão menor mais recente. A partir do MongoDB 8.2, versões secundárias estão disponíveis para implantações locais (Community e EA) para casos de uso específicos. Para mais informações, consulte Versão do MongoDB.
Para instalar a versão mais recente do MongoDB compatível com uso local, consulte as instruções de instalação.
Familiarize-se com o conteúdo deste documento, incluindo a revisão minuciosa dos pré-requisitos, antes de atualizar com o MongoDB 8.3.
As etapas a seguir descrevem o procedimento de upgrade de um mongod autônomo da versão 8.0 para a 8.3.
Se você precisar de orientação para atualizar para 8.3 o, os serviços profissionais do MongoDB oferecem suporte de atualização para ajudar a garantir uma transição tranquila, sem interrupção para seu aplicação 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 8.3, você deve estar executando uma versão da série 8.0.
Ao atualizar de uma versão secundária, você deve atualizar sucessivamente as versões secundárias até ter atualizado para 8.3.
Para saber mais,consulte Atualizar 8.2 8.3para.
Verifique a compatibilidade do driver
Antes de fazer upgrade do MongoDB, verifique se você está usando um driver compatível com o MongoDB 8.3. Consulte a documentação do driver para seu driver específico para verificar a compatibilidade com o MongoDB 8.3.
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 8.3 para garantir que seus aplicativos e sistemas sejam compatíveis com o MongoDB 8.3. 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
A partir do MongoDB 8.3, você pode fazer downgrade da sua versão do MongoDB para a versão secundária ou principal imediatamente anterior.
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 fazer downgrade de um 8.0 para um 7.0 sistema. No entanto, não há suporte para desatualização adicional dessa implantação 7.0 para uma implantação 6.0.
Para saber mais, consulte Downgrade 8.3 para 8.0.
Pré-requisitos
Versão de compatibilidade de recursos
A instância do 8.0 deve ter featureCompatibilityVersion configurado para "8.0". Para verificar featureCompatibilityVersion, execute o seguinte comando:
db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
"featureCompatibilityVersion" : { "version" : "8.0" }
Para mais informações, consulte db.adminCommand().
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 8.3 Binários
Usar um 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 8.3 utilizando seu gerenciador de pacotes.
Siga as instruções de instalação do8.3 apropriadas para seu sistema Linux. Isso requer adicionar um repositório para a nova versão e, em seguida, executar o processo de upgrade 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 8.3 para obter mais informações.
Procedimento de atualização
Habilitar funcionalidades 8.3 incompatíveis com versões anteriores
Neste ponto, você pode executar o 8.3 binários sem os recursos recursos do 8.3 que são incompatíveis com 8.0.
Para habilitar estas funcionalidades do 8.3, configure a versão de compatibilidade do recurso (FCV) para 8.3. Você também deve definir confirm como true.
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: "8.3", confirm: true } )
Definir o valor confirm para true permite que a operação continue. Se você omitir o parâmetro confirm ou definir confirm como um valor diferente de true, o comando falhará e retornará um aviso sobre a modificação da versão de compatibilidade do recurso.
Este comando deve executar gravações em uma collection interna do sistema. Se o comando não for concluído com êxito, você poderá tentar novamente com segurança, pois a operação é idempotente.
Solução de problemas
Se mongod sair, o MongoDB retornará um código. Para solucionar problemas com sua atualização, consulte Códigos de erro ou Códigos de saída e status para um sistema autogerenciado.
Procedimentos de atualização adicionais
Para atualizar um conjunto de réplicas, consulte Atualizar conjunto de réplicas 8.0 8.3 para.
Para atualizar um cluster fragmentado, consulte Atualizar 8.0 cluster fragmentado 8.3 para.