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 seguintes etapas esboçam o procedimento para atualizar um mongod que é um membro do conjunto de réplica da versão 8.2 para 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.
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.2.
Pré-requisitos
Versão de todos os membros
Todos os nós do conjunto de réplicas devem executar 8.2 a versão. Para atualizar um conjunto de réplicas do 6.0 e anterior, primeiro atualize todos os membros do conjunto de réplicas para a 8.0versão mais recente da série e, em seguida, siga o procedimento para atualizar do 8 MongoDB.2 8para3..
Versão de compatibilidade de recursos
O 8.2 conjunto de réplicas deve ter featureCompatibilityVersion definido como "8.2".
Para garantir que todos os membros do conjunto de réplicas tenham featureCompatibilityVersion configurado para "8.2", conecte a cada membro do conjunto de réplicas e marque o featureCompatibilityVersion:
db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
"featureCompatibilityVersion" : { "version" : "8.2" }
Para definir ou atualizar featureCompatibilityVersion, execute o seguinte comando no primário. A maioria dos membros portadores de dados deve estar disponível:
db.adminCommand( { setFeatureCompatibilityVersion: "8.2" , confirm: true } )
Para mais informações, consulte setFeatureCompatibilityVersion.
Estado do membro do conjunto de réplicas
Emita o replSetGetStatus comando para garantir que nenhum membro do conjunto de réplicas esteja no estado ROLLBACK RECOVERING ou:
db.adminCommand( { replSetGetStatus: 1 } )
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
É possível atualizar o MongoDB da versão 8.2 para a versão 8.3 com uma atualização "contínua," que permite atualizar um nó de cada vez, mantendo os demais em funcionamento para minimizar o tempo de inatividade.
Atualizar membros secundários do conjunto de réplicas
Atualize os membros secundários da réplicas para definir um de cada vez:
Substitua o 8.2 binário pelo 8.3 binário.
Reinicie o membro.
Reduza o conjunto de réplicas primário
Conecte o mongosh ao primary e utilize o rs.stepDown() para descer o primary e forçar uma eleição de uma novo primary.
Atualizar o primário anterior
Quando rs.status() indicar que o primário foi desativado e outro membro tiver assumido o estado PRIMARY, faça upgrade do primário desativado:
Encerre o primário desativado e substitua o binário
mongodpelo binário 8.3 .Reinicie o membro.
Habilitar funcionalidades 8.3 incompatíveis com versões anteriores
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.
Neste ponto, você pode executar o 8.3 binários sem os recursos recursos do 8.3 que são incompatíveis com 8.2.
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
Certifique-se de que não haja sincronização inicial em andamento. A execução do setFeatureCompatibilityVersion comando enquanto uma sincronização inicial estiver em andamento faz com que a sincronização inicial seja reiniciada.
No primário, execute o comando setFeatureCompatibilityVersion no banco de dados admin :
db.adminCommand( { setFeatureCompatibilityVersion: "8.3", confirm: true } )
Definindo featureCompatibilityVersion (FCV) : "8.3" executa implicitamente um para replSetReconfig term adicionar o campo ao documento de configuração e bloqueia até que a nova configuração se propague para a maioria dos membros do conjunto de réplicas.
Este comando deve executar gravações em uma collection interna do sistema. Se o comando não for concluído, você poderá tentar novamente o comando no primary com segurança, pois a operação é idempotente.
Procedimentos de atualização adicionais
Para atualizar um autônomo, consulte 8.2 Atualizar standalone 8.3 para.
Para atualizar um cluster fragmentado, consulte Atualizar 8.2 cluster fragmentado 8.3 para.