Atualize para a versão de patch autogerenciada mais recente do MongoDB
Nesta página
Os números de versão do MongoDB têm o formato X.Y.Z
, onde Z
se refere ao número da versão do patch. Os lançamentos de patches fornecem patches de segurança, correções de erros e recursos novos ou alterados que geralmente não contêm nenhuma alteração retroativa. Sempre atualize para a versão de patch mais recente em sua série de lançamentos.
Para mais informações sobre versionamento, consulte Versionamento do MongoDB.
Sobre esta tarefa
Esta página descreve os procedimentos de atualização para a série de lançamento do MongoDB 7.0. Para atualizar uma série de versões diferentes, consulte a versão correspondente do manual.
Antes de começar
Revise as seguintes seções para garantir que sua implantação esteja pronta para ser atualizada.
Backup.
Verifique se você tem um backup atualizado do seu conjunto de dados. Consulte Métodos de backup para um sistema autogerenciado.
Considerações de compatibilidade
Consulte os documentos a seguir para considerações especiais ou problemas de compatibilidade específicos de sua versão do MongoDB:
Janela de manutenção
Se a sua instalação incluir conjuntos de réplicas, defina o upgrade para ocorrer durante uma janela de manutenção predefinida.
Verificação do ambiente de preparo
Antes de atualizar um ambiente de produção, use os procedimentos deste documento para atualizar um ambiente de preparo que reproduz seu ambiente de produção. Certifique-se de que sua configuração de produção seja compatível com todas as alterações antes de atualizar.
Passos
Atualize cada mongod
e mongos
binário separadamente. Siga este procedimento de atualização:
Para implantações que usam autenticação, primeiro faça upgrade de todos os seus drivers do MongoDB. Para fazer upgrade, consulte a documentação do driver.
Faça upgrade de quaisquer instâncias autônomas. Consulte Faça upgrade de uma instância do MongoDB.
Atualize quaisquer conjuntos de réplicas que não façam parte de um cluster fragmentado, conforme descrito em Atualização de conjuntos de réplicas.
Atualize clusters fragmentados, conforme descrito em Fazer upgrade de clusters fragmentados.
Atualizar uma instância do MongoDB
Para atualizar uma instância mongod
7.0 ou mongos
, use uma destas abordagens:
Atualize a instância usando a ferramenta de gerenciamento de pacotes do sistema operacional e os pacotes oficiais do MongoDB. Essa é a abordagem preferencial. Consulte Instale o MongoDB.
Atualize a instância substituindo os binários existentes por novos binários. Consulte Substitua os binários existentes.
Substitua os binários existentes
Esta seção descreve como atualizar o MongoDB substituindo os binários existentes. A abordagem preferencial para uma atualização é usar a ferramenta de gerenciamento de pacotes do sistema operacional e os pacotes oficiais do MongoDB, conforme descrito em Instale o MongoDB.
Para atualizar uma instância do mongod
ou mongos
substituindo os binários existentes:
Baixe os binários para a versão de patch mais recente do MongoDB na página de download do MongoDB e armazene os binários em um local temporário. Os binários são baixados como arquivos compactados que descompactam na estrutura de diretórios usada pela instalação do MongoDB.
Desligue a instância.
Substitua os binários MongoDB existentes pelos binários baixados.
Faça as alterações necessárias no arquivo de configuração.
Reinicie a instância.
Atualizar conjuntos de réplicas
Para atualizar um conjunto de réplicas 7.0, atualize cada membro individualmente, começando com os secundários e terminando com o primário. Planeje a atualização durante uma janela de manutenção predefinida.
Importante
Antes de atualizar ou fazer downgrade de um conjunto de réplicas, certifique-se de que todos os membros do conjunto de réplicas estejam em execução. Se você não fizer isso, a atualização ou downgrade não será concluído até que todos os membros sejam iniciados.
Atualize os secundários
Faça o upgrade de cada secundário separadamente da seguinte forma:
Atualize o binário do secundário
mongod
seguindo as instruções em Atualize uma instância MongoDB.Depois de atualizar um secundário, aguarde até que o secundário se recupere para o estado
SECONDARY
antes de atualizar a próxima instância. Para verificar o estado do membro, emitars.status()
emmongosh
.O secundário pode entrar brevemente em
STARTUP2
ouRECOVERING
. Isso é normal. Certifique-se de aguardar até que o secundário se recupere totalmente paraSECONDARY
antes de continuar a atualização.
Atualize o primário
Reduza o primário para iniciar o procedimento de failover normal. Usando uma das seguintes opções:
O assistente
rs.stepDown()
emmongosh
.O comando do banco de dados do
replSetStepDown
.
Durante o failover, o conjunto não pode aceitar gravações. Normalmente, isso leva de 10 a 20 segundos. Planeje a atualização durante uma janela de manutenção predefinida.
Observação
É preferível reduzir o primário do que desligá-lo diretamente. A saída agiliza o procedimento de failover.
Depois que o primário for reduzido, chame o método
rs.status()
demongosh
até que você veja que outro membro assumiu o estadoPRIMARY
.Desligue o primário original e atualize sua instância seguindo as instruções em Fazer upgrade de uma instância do MongoDB.
Atualizar clusters fragmentados
Para atualizar um cluster fragmentado 7.0:
Desative o balanceador do cluster conforme descrito em Desabilite o balanceador.
Atualize os servidores de configuração.
Para atualizar o conjunto de réplicas do servidor de configuração, use os procedimentos descritos em Atualize os conjuntos de réplicas.
Atualize cada fragmento.
Se um fragmento for um conjunto de réplicas, atualize o fragmento utilizando o procedimento intitulado Atualizar conjuntos de réplicas.
Se um fragmento for uma instância autônoma, atualize o fragmento usando o procedimento intitulado Atualize uma instância do MongoDB.
Após os servidores de configuração e os fragmentos terem sido atualizados, atualize cada instância do
mongos
seguindo as instruções na página Atualizar uma instância do MongoDB. É possível atualizar as instâncias domongos
em qualquer ordem.Reative o balanceador, conforme descrito em Ative o balanceador.