Página inicial do Docs → Desenvolver aplicações → Manual do MongoDB
Atualizar um conjunto de réplicas para 4.4
Nesta página
Aviso
Ao atualizar um sistema da série 4.2 do MongoDB contendo metadados do MongoDB 3.0 para um sistema da série 4.4, você deve atualizar para o MongoDB 4.4.1 ou posterior. Você não pode atualizar com êxito uma implantação contendo metadados do MongoDB 3.0 para o MongoDB 4.4.0 sem um grave risco de tempo de inatividade.
Para obter mais informações, consulte WT-6623.
Use este tutorial para atualizar do MongoDB 4,2 para o MongoDB 4,4. Para atualizar para uma nova versão de patch dentro da mesma série de versão, consulte Atualizar para a versão de patch mais recente do MongoDB.
Familiarize-se com o conteúdo deste documento, incluindo a revisão minuciosa dos pré-requisitos, antes de atualizar para MongoDB 4.4.
Se precisar de orientação sobre como atualizar para 4.4, os serviços profissionais do MongoDB oferecem suporte à atualização da versão principal para ajudar a garantir uma transição sem interrupções 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 4.4, você deve estar executando uma versão da série 4.2.
Para atualizar de uma versão anterior ao 4.2-, você deve atualizar sucessivamente as principais versões até ter atualizado para 4.2-série. Por exemplo, se você estiver executando um 4.0- série, você deve primeiro atualizar para 4.2 antes de atualizar para 4.4.
Verifique a compatibilidade do driver
Antes de atualizar o MongoDB, verifique se você está utilizando um MongoDB 4.4-driver compatível. Consulte a documentação do driver específico para verificar a compatibilidade com o MongoDB 4.4.
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 4.4 para garantir que seus aplicativos e sistemas sejam compatíveis com o MongoDB 4.4. Resolva as incompatibilidades no seu sistema 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 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.
Aviso
Downgradefloor
Se você precisar fazer o downgrade da versão 4.4, faça o downgrade para a 4.2.6 ou uma versão posterior. Você não pode fazer o downgrade para a 4.2.5 ou uma versão anterior.
Pré-requisitos
Versão de todos os membros
Todos os nós do conjunto de réplicas devem estar executando a versão 4.2. Para atualizar um conjunto de réplicas de um 4.0- série e anterior, primeiro atualize todos os membros do conjunto de réplicas para o 4 mais recente.2-versão da série e siga o procedimento para atualizar do MongoDB 4.2 a 4.4.
Confirmar desligamento limpo
Antes de fazer upgrade de um membro do conjunto de réplicas, confirme se o membro foi desligado de forma limpa.
Versão de compatibilidade de recursos
O conjunto de réplicas do 4.2 deve ter featureCompatibilityVersion definido como "4.2".
Para garantir que todos os membros do conjunto de réplicas tenham featureCompatibilityVersion configurado para "4.2", conecte a cada membro do conjunto de réplicas e marque o featureCompatibilityVersion:
db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
Todos os membros devem retornar um resultado que inclua "featureCompatibilityVersion" : { "version" : "4.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: "4.2" } )
Para mais informações, consulte setFeatureCompatibilityVersion.
Estado do membro do conjunto de réplicas
Garanta que nenhum membro do conjunto de réplicas esteja no estado ROLLBACK ou RECOVERING.
Baixar binários 4.4
Através do Gerenciador de Pacotes
Se você instalou o MongoDB a partir dos repositórios MongoDB apt, yum, dnf ou zypper , deve atualizar para a versão 4.4 usando o gerenciador de pacotes.
Siga as instruções de instalação apropriadas do 4.4 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 do 4.4 para obter mais informações.
Processo de atualização
Você pode atualizar do MongoDB 4.2 para o 4.4 usando uma atualização "contínua," que permite atualizar um nó de cada vez, mantendo os demais em funcionamento para minimizar o tempo de inatividade.
Atualize os membros secundários do conjunto de réplicas.
Atualize os membros secundários da réplicas para definir um de cada vez:
Desligue a instância
mongode substitua o binário 4.2 pelo binário 4.4.Reinicie o membro.
Reduza o conjunto de réplicas primário.
Conecte uma shell do mongo ao primário e use o rs.stepDown() para descer o primário e forçar a eleição de uma nova primária.
Atualize o primary.
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 4.4.Reinicie o membro.
Ative recursos 4.4 incompatíveis com versões anteriores.
Neste ponto, você pode executar os binários 4.4 sem as funcionalidades 4.4 que são incompatíveis com o 4.2.
Para habilitar essas funcionalidades do 4.4, defina a versão de compatibilidade do recurso (fCV) para 4.4.
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.
Dica
Certifique-se de que não haja initial sync em andamento. A execução do comando setFeatureCompatibilityVersion enquanto uma initial sync estiver em andamento fará com que a initial sync seja reiniciada.
No primário, execute o comando setFeatureCompatibilityVersion no banco de dados admin :
db.adminCommand( { setFeatureCompatibilityVersion: "4.4" } )
Definindo featureCompatibilityVersion (fCV) : "4,4" executa implicitamente um replSetReconfig para adicionar o campo term 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, por algum motivo, o comando não for concluído com êxito, você poderá tentar novamente o comando no primary com segurança, pois a operação é idempotente.
Procedimentos de atualização adicionais
Para atualizar um standalone, consulte Atualizar um standalone para 4.4.
Para atualizar um cluster fragmentado, consulte Atualizar um cluster fragmentado para 4.4.