Atualize o Ops Manager
Este tutorial descreve como atualizar uma instalação existente do Ops Manager.
Caminho de atualização
Aviso
Atualize bancos de dados gerenciados para MongoDB 4.4 ou posterior
MongoDB Ops Manager 8.0 não é compatível com o MongoDB 4.2 e versões anteriores. Se você estiver usando o MongoDB 4.2 ou anterior e quiser atualizar para o MongoDB Ops Manager 8.0, deverá atualizar pelo menos para o MongoDB 4.4. No entanto, recomendamos que você atualize para pelo menos MongoDB 6.0 antes de atualizar para o MongoDB Ops Manager 8.0.
A versão da instalação existente do Ops Manager determina o caminho de atualização que você deve seguir para atualizar para o Ops Manager 4.4 ou posterior.
Importante
Se você tiver uma instalação do MongoDB Ops Manager 4.2 ou posterior com mais de um host do MongoDB Ops Manager apontando para o mesmo banco de dados de aplicativos, poderá atualizar o MongoDB Ops Manager sem incorrer no tempo de inatividade do monitoramento. Durante essa atualização, o MongoDB Ops Manager entra em um estado conhecido como Modo de Atualização. Consulte Modo de atualização para obter mais informações.
Para garantir um upgrade bem-sucedido, você deve seguir o caminho de upgrade da versão existente para realizar as migrações de banco de dados necessárias.
Para proteger seus dados, o Ops Manager se recusa a iniciar atualizações diretas das versões 1.8.x e 2.0.x para a versão 3.4 ou posterior.
Não há caminhos de downgrade suportados para o Ops Manager.
Observação
Todas as atualizações para as versões 6.0.x e posteriores do MongoDB Ops Manager utilizam o mesmo procedimento. Para atualizar para uma versão superior, você deve primeiro usar este procedimento de atualização para o patch mais recente disponível da sua versão inicial e, em seguida, usar o procedimento novamente para atualizar para a próxima versão. Se a tabela abaixo contiver informações adicionais relacionadas ao procedimento de atualização para uma determinada versão, analise-a primeiro.
Importante
Migração em tempo real (push) obsoleta ou sem suporte para implantações de origem gerenciadas ou monitoradas pelo Ops Manager
Para implantações de origem que executam qualquer versão do MongoDB 6.0.+ em que as implantações são gerenciadas ou monitoradas pelo Ops Manager, a migração ao vivo (push) não é suportada.
Para implantações de origem que executam qualquer MongoDB 5.0 e versões anteriores, em que as implantações são gerenciadas ou monitoradas pelo Ops Manager, a migração ao vivo (push) é preterida.
Para implantações de origem com o MongoDB 6.0.+, onde as implantações são monitoradas pelo Cloud Manager, a migração de produção (push) é suportada. Para saber mais, consulte Migração em produção do seu cluster do MongoDB monitorado pelo Cloud Manager para o Atlas.
A tabela a seguir lista caminhos de atualização para todas as versões:
Versão existente | Caminho de atualização |
|---|---|
8.0.x | Faça a atualização do MongoDB Ops Manager 8.0.x para a versão de correção mais recente disponível do 8.0 utilizando este procedimento. Para saber mais, consulteas notas de versão do MongoDB Ops Manager 8.0. |
7.0.x | Faça a atualização do MongoDB Ops Manager 7.0.x para a versão de correção mais recente disponível do 7.0. Em seguida, atualize para a versão mais recente disponível do 8.0. Use este procedimento para ambas as atualizações. Para saber mais, consulte as notas de versãoMongoDB Ops Manager 7.0. |
6.0.x | Faça a atualização do MongoDB Ops Manager 6.0.x para a versão de correção mais recente disponível do 6.0. Em seguida, atualize para a versão mais recente disponível do 7.0. Use este procedimento para ambas as atualizações. Para saber mais, consulte as notas de versãoMongoDB Ops Manager 6.0. |
5.0.x | Faça a atualização do MongoDB Ops Manager 5.0.x para a versão de correção mais recente disponível do 5.0. Em seguida, atualize para a versão mais recente disponível do 6.0. Use este procedimento para ambos os processos. Para saber mais, consulte as notas de versãoMongoDB Ops Manager 5.0. |
4.4.x | Faça a atualização do MongoDB Ops Manager 4.4.x para a versão de correção mais recente disponível do 4.4. Em seguida, atualize para a versão mais recente disponível do 5.0. Use este procedimento para ambos os processos. IMPORTANTE: MongoDB Ops Manager versão 4.4.13 corrige um bug que reativaria as instâncias MongoDB Ops Manager para gravações daAPI durante uma atualização. Para saber mais, consulte: |
4.2.x | Faça a atualização do MongoDB Ops Manager 4.2.x para a versão de correção mais recente disponível do 4.2. Em seguida, atualize para a versão mais recente disponível do 4.4. Use este procedimento para ambos os processos. Uma desativação não intencional e temporária do TLS ocorre ao atualizar para versões anteriores ao 4.2.24. Atualizar para 4.2.24 ou posterior evita primeiro esse resultado. Para saber mais, consulte: |
4.0.x | Use o tutorial de atualização do v4.2 para atualizar do MongoDB Ops Manager 4.0.x para a versão 4.2.24 ou posterior. Em seguida, use este procedimento para atualizar para a versão mais recente disponível do 4.2. Uma desativação não intencional e temporária do TLS ocorre ao atualizar para versões anteriores ao 4.2.24. Atualizar para 4.2.24 ou posterior evita primeiro esse resultado. Para saber mais, consulte: |
3.6.x | Use o tutorial de atualização do v4.0 para atualizar do MongoDB Ops Manager 3.6.x para a versão 4.0.x. |
3.4.x | Use o tutorial de atualização do v3.6 para atualizar do MongoDB Ops Manager 3.4.x para a versão 3.6.x. |
2.x ou anterior | Use o tutorial de atualização v3.4 para atualizar do MongoDB Ops Manager 2.x ou anterior. |
Aviso
Para manter as configurações e a disponibilidade existentes, faça backup dos itens abaixo na sua instância atual do Ops Manager:
conf-mms.propertiese arquivosgen.keyem um local seguro. Oconf-mms.propertiesarmazena configurações para a instância do MongoDB Ops Manager . O gen.key fornece detalhes para criptografar e descriptografar os bancos de dados de backup e as credenciais do usuário do Ops Managers. MongoDB Ops Manager pode excluir esses arquivos como parte do processo de atualização.
Como precaução extra, você pode usar mongodump para criar uma exportação binária do Banco de Dados de Aplicativos. Não existe nenhum método de backup oficialmente suportado para o banco de dados de aplicativos. Se a atualização falhar, entre em contato com o Suporte doMongoDB para obter ajuda para corrigir o problema com a versão do MongoDB Ops Manager .
Considerações
Antes de atualizar o MongoDB Ops Manager de 7.0 para 8.0, revise as seguintes considerações:
Bancos de dados de backup
MongoDB Ops Manager 8.0.0 requer no mínimo o MongoDB 6.0.0 para bancos de dados de suporte MongoDB Ops Manager .
Observação
Sua versão do MongoDB para bancos de dados de suporte do Ops Manager não pode ser posterior à sua versão do Ops Manager.
Ferramentas compatíveis com o MongoDB
Se o gerente de operações gerenciar suas ferramentas MongoDB, as versões da ferramenta serão atualizadas quando você atualizar o gerente de operações.
Se você executar o MongoDB Ops Manager 8.0.x no modo local, deverá baixar e instalar uma versão compatível do pacote MongoDB Tools TGZ no diretório versions.
Versões do servidor do Ops Manager | Versão compatível das ferramentas de banco de dados do MongoDB |
|---|---|
Para acessar versões mais antigas das Ferramentas MongoDB, clique em Versões arquivadas na página Download.
Suporte à plataforma do Ops Manager
Remove o suporte do Ops Manager para o RedHat Enterprise Linux 7.
Remove o suporte do Ops Manager para o SUSE Linux Enterprise Server 12.
Remove a compatibilidade do Ops Manager para Ubuntu 20.04 LTS.
Importante
Descontinua o suporte do Ops Manager para Amazon Linux v2 LTS.
Encerra a compatibilidade do Ops Manager para Debian 11.
Mudanças no suporte de automação
Remove o suporte para automatizar, monitorar e fazer backup das versões 4.2 e anteriores do MongoDB . MongoDB Ops Manager só pode gerenciar bancos de dados que executam o MongoDB 4.4 ou superior.
Importante
Substitui o suporte para automatizar, monitorar e fazer backup das versões 5.0 e anteriores do MongoDB .
Observação
Os queryable backups não são compatíveis quando você usa shards de configuração.
Pré-requisitos
Requisitos de hardware e software
Seus servidores devem atender aos requisitos de sistema do Ops Manager.
Aviso
Potencial para falha de produção
Sua instância do Ops Manager pode falhar em produção se você não configurar o seguinte:
O gerente de operações hospeda de acordo com os requisitos de sistema do gerente de operações.
Hosts do MongoDB de acordo com as Notas de produção no manual do MongoDB. As instâncias do MongoDB no Ops Manager incluem:
O banco de dados de aplicativos do Ops Manager,
Cada blockstore.
Certifique-se de que todos os membros portadores de dados estejam em execução antes de iniciar o processo de atualização. Para determinar o status dos membros do conjunto de réplicas, execute replSetGetStatus.
Se os seus bancos de dados de apoio executarem o mecanismo storage engine MMAPv1, o processo de atualização não funcionará. O MongoDB Ops Manager solicita que você atualize o storage engine dos bancos de dados de apoio para o WiredTiger.
Privilégios de administrador
Você deve ter privilégios de administrador nos servidores nos quais executa a atualização.
Baixar software do MongoDB
Para baixar o software, clique no link de download disponível na página de downloads do cliente. O MongoDB fornece a URL dessa página aos clientes.
Se você não conseguir acessar esse link, visite a página de download para obter uma cópia de avaliação atual do software Ops Manager.
Se você precisar de uma versão anterior do software Ops Manager, visite o Release Archive.
Baixe o software para executar no modo local
Se você planeja executar o Ops Manager no Modo Local, baixe o software MongoDB para o diretório da biblioteca de versões. O software necessário inclui:
Todas as versões do MongoDB Community ou Enterprise que você deseja instalar
Ferramentas do MongoDB. A versão das ferramentas do MongoDB deve corresponder à versão listada nas notas de versão do Ops Manager como compatível com sua versão do Ops Manager.
Compatibilidade de plataforma
Antes de atualizar o Ops Manager, certifique-se de que:
A plataforma dos hosts que atendem Ops Manager é compatível com 5.0.
Os MongoDB Agents que gerenciam seus MongoDB deployments são compatíveis com o Ops Manager 5.0.
A plataforma dos hosts que atendem os agentes do Ops Manager é compatível com os Agents.
Se você usar o BI Connector, atualize o MongoDB para 4.4 ou posterior.
Se você atualizou a plataforma para os hosts do agente MongoDB, atualize os agentes do MongoDB antes de atualizar o gerente de operações.
Procedimento
Observação
Modo de atualização para aplicativos altamente disponíveis
Se você tiver uma instalação do Ops Manager 4.2 ou posterior com mais de um host do Ops Manager apontando para o mesmo banco de dados de aplicativos, poderá atualizar o Ops Manager sem incorrer em tempo de inatividade de monitoramento. Durante esta atualização, o gerente de operações insere um estado conhecido como Modo de atualização. Este modo permite os seguintes benefícios durante o processo de atualização:
Alertas e monitoramento operam
As instâncias do Ops Manager permanecem ativas
O aplicativo do gerente de operações pode ser acessado no modo somente leitura
APIs do Ops Manager que gravam ou excluem dados estão desabilitadas
Sua instância do Ops Manager permanece no Modo de atualização até que todos os hosts do Ops Manager tenham sido atualizados e reiniciados.
Você não deve atualizar mais de um host do Ops Manager de cada vez.
Quando o Ops Manager entra no modo de atualização, os Backup Daemons tentam parar a si mesmos. Esse processo pode falhar se os Daemons estiverem no meio de uma longa tarefa de backup. Nesse caso, siga um destes procedimentos:
Reinicie a primeira instância do Ops Manager assim que os Backup Daemons terminarem a tarefa.
Pare os Backup Daemons manualmente.
Para interromper manualmente seus Backup Daemons:
Faça login no primeiro host que disponibiliza um Backup Daemon.
Emitir o seguinte comando:
sudo service mongodb-mms-backup-daemon stop Verifique se você desligou o Backup Daemon:
ps -ef | grep mongodb-mms-backup-daemon Se o Backup Daemon continuar em execução, emita este comando:
sudo /etc/init.d/mongodb-mms-backup-daemon stop Repita as etapas 2 a 3 com cada outro host do Backup Daemon.
Faça login no primeiro host que disponibiliza um Backup Daemon.
Emitir o seguinte comando:
sudo service mongodb-mms-backup-daemon stop Verifique se você desligou o Backup Daemon:
ps -ef | grep mongodb-mms-backup-daemon Se o Backup Daemon continuar em execução, emita este comando:
sudo /etc/init.d/mongodb-mms-backup-daemon stop Repita as etapas 2 a 3 com cada outro host do Backup Daemon.
Faça login no primeiro host que disponibiliza um Backup Daemon.
Emitir o seguinte comando:
<install_dir>/bin/mongodb-mms-backup-daemon stop Verifique se você desligou o Backup Daemon:
ps -ef | grep mongodb-mms-backup-daemon Se o Backup Daemon continuar em execução, emita este comando:
sudo /etc/init.d/mongodb-mms-backup-daemon stop Repita as etapas 2 a 3 com cada outro host do Backup Daemon.
Se você estiver executando seu aplicativo do Ops Manager em uma configuração de alta disponibilidade, conclua este procedimento em um host do Ops Manager de cada vez.
Use este procedimento para atualizar o Aplicativo Ops Manager em hosts instalados usando pacotes deb :
Baixe a versão mais recente do pacote Ops Manager.
Abra seu navegador preferido para acessar o MongoDB Download Center em MongoDB.com.
Se começar a partir de MongoDB.com, clique em Products Ops Manager Try it now.
No menu suspenso Platforms, clique em Ubuntu 22.04.
No menu suspenso Packages, clique em DEB para arquitetura x86_64.
Clique em Download.
O pacote baixado é denominado
mongodb-mms-<version>.x86_64.deb, onde<version>é o número da versão.
Instale o pacote do Ops Manager no host que você está atualizando.
Observação
Modo de Atualização para Aplicativos do Ops Manager Altamente Disponíveis
Se você tiver uma instalação do Ops Manager 4.4 com mais de um host do Ops Manager apontando para o mesmo aplicativo de banco de dados, este sistema do Ops Manager será executado com alta disponibilidade. Depois de atualizar um host do Ops Manager de um sistema do Ops Manager altamente disponível, esse sistema entra no Modo de atualização.
Instale o pacote
.debem cada aplicativo de Ops Manager e host do Backup Daemon. Emita o seguinte comando, onde<version>é a versão do pacote.deb:sudo dpkg -i mongodb-mms_<version>_x86_64.deb Quando solicitado se deseja substituir a versão atualmente instalada do
mms.conf, você deve digitarYpara substituir o arquivo existente.Se você modificou as portas ou as configurações de JVM que o Ops Manager utiliza, você precisará reaplicar estas alterações no arquivo
mms.confapós o Ops Manager ser atualizado.Aviso
Não adicione senhas ou segredos aos argumentos JVM no arquivo
mms.conf. MongoDB Ops Manager os expõe como texto simples nos arquivos de diagnóstico.A atualização para o Ops Manager 4.1 e 4.2 removeu o sinalizador
-d64do parâmetroJAVA_MMS_UI_OPTS.Ao atualizar para o Ops Manager 4.4.11, o Ops Manager solicita que você escolha qual versão do arquivo
/opt/mongodb/mms/conf/conf-mms.propertiesele deve utilizar. Para evitar ter que reconfigurar manualmente o Ops Manager, escolha o arquivo atual. Para mais informações, consulte Notas de versão do 4.4.11.
Inicie o Ops Manager no host atualizado.
sudo service mongodb-mms start
Observação
Em instâncias de alta disponibilidade do Ops Manager, o Backup Daemon espera que todos os nós atualizem antes de iniciar.
Faça login em seu host atualizado do Ops Manager depois que ele for reiniciado. Se seu login for bem-sucedido, a atualização foi bem-sucedida.
[Opcional] Repita as etapas anteriores para todos os outros hosts do Ops Manager em sua implantação de Alta Disponibilidade.
Observação
Os registros que o MongoDB Ops Manager gera durante a inicialização podem pausar temporariamente em Starting pre-flight checks enquanto o MongoDB Ops Manager atualiza todos os seus servidores para a mesma versão.
Se sua atualização for bem-sucedida, repita as etapas 1 a 4 no próximo host em sua implantação do Ops Manager de alta disponibilidade.
Atualizar todos os Agentes.
Assim que a atualização for concluída, faça login na instância do Ops Manager. O Ops Manager exibe um banner que diz One or more agents are out of date.
Clique em Update All Agents e confirme as alterações.
Importante
Se o Ops Manager gerenciar suas ferramentas do MongoDB, as versões das ferramentas serão atualizadas com os agentes.
Se o gerente de operações gerenciar seu conector de BI, a versão do conector de BI será atualizada com os agentes.
Use este procedimento para atualizar o Aplicativo Ops Manager em hosts instalados usando pacotes rpm :
Pare sua primeira instância do Ops Manager em execução.
Em hosts RHEL, CentOS, SUSE12 que usam systemd, emita o seguinte comando para interromper o MongoDB Ops Manager aplicativo :
sudo service mongodb-mms stop
Para plataformas que usam o SysVInit, emita o seguinte comando:
sudo /etc/init.d/mongodb-mms stop
Baixe a versão mais recente do pacote Ops Manager.
Abra seu navegador preferido para visitar o MongoDB Download Center em MongoDB.com.
Se começar a partir de MongoDB.com, clique em Products Ops Manager Try it now.
No menu suspenso Platforms, clique em uma das seguintes opções:
Red Hat + CentOS 7, 8, 9 / SUSE 12 + 15 / Amazon Linux 2, Amazon Linux 2023
No menu suspenso Packages, clique em RPM.
Clique em Download.
O pacote baixado é denominado
mongodb-mms-<version>.x86_64.rpm, onde<version>é o número da versão.
Instale o pacote do MongoDB Ops Manager MongoDB Ops Manager host do MongoDB Ops Manager que você está atualizando.
Observação
Modo de Atualização para Aplicativos do Ops Manager Altamente Disponíveis
Se você tiver uma instalação do Ops Manager 4.4 com mais de um host do Ops Manager apontando para o mesmo aplicativo de banco de dados, este sistema do Ops Manager será executado com alta disponibilidade. Depois de atualizar um host do Ops Manager de um sistema do Ops Manager altamente disponível, esse sistema entra no Modo de atualização.
Para instalar o pacote .rpm no host atualizado do MongoDB Ops Manager , emita o seguinte comando, onde <version> é a versão do MongoDB Ops Manager :
sudo rpm -Uvh mongodb-mms-<version>.x86_64.rpm
Aviso
rpm pacotes para as versões 6.0.0, 6.0.1 e 6.0.2 do Ops Manager continham informações de versão incorretas que poderiam causar falha nas atualizações padrão. Se você estiver atualizando de qualquer uma dessas versões para a versão 6.0.3 ou superior, atualize o pacote usando o sinalizador --force :
sudo rpm -Uvh --force mongodb-mms-<version>.x86_64.rpm
Ao atualizar para o MongoDB Ops Manager 5.0.x, O MongoDB Ops Manager mantém o arquivo /opt/mongodb/mms/conf/conf-mms.properties atual. O MongoDB Ops Manager salva o conf-mms.properties instalado com esta versão como /opt/mongodb/mms/conf/conf-mms.properties.rpmnew.
Aviso
Não adicione senhas ou segredos aos argumentos JVM no arquivo mms.conf . MongoDB Ops Manager os expõe como texto simples nos arquivos de diagnóstico.
Substitua init arquivos por links simbólicos
Os seguintes arquivos existentes bloqueiam a atualização de uma instalação MongoDB Ops Manager 4.2 usando RPM:
/etc/init.d/mongodb-mms/etc/init.d/mongodb-mms-backup-daemon
Para concluir a atualização:
Emita os seguintes comandos para mover os arquivos
initantigos:sudo mv /etc/init.d/mongodb-mms /etc/init.d/mongodb-mms-5.0 sudo mv /etc/init.d/mongodb-mms-backup-daemon /etc/init.d/ mongodb-mms-backup-daemon-5.0 sudo mv /etc/init.d/mongodb-mms /etc/init.d/mongodb-mms-6.0 sudo mv /etc/init.d/mongodb-mms-backup-daemon /etc/init.d/ mongodb-mms-backup-daemon-6.0 Emitir os seguintes comandos para vincular simbolicamente os arquivos do MongoDB Ops Manager aos seus arquivos
init:sudo ln -s /opt/mongodb/mms/bin/mongodb-mms /etc/init.d/mongodb-mms sudo ln -s /opt/mongodb/mms/bin/mongodb-mms-backup-daemon /etc/init.d/mongodb-mms-backup-daemon
Inicie o Ops Manager no host atualizado.
Em hosts RHEL, CentOS, SUSE12 que usam systemd, emita o seguinte comando:
sudo service mongodb-mms start
Para plataformas que usam o SysVInit, emita o seguinte comando:
sudo /etc/init.d/mongodb-mms start
Observação
Os registros que o MongoDB Ops Manager gera durante a inicialização podem pausar temporariamente em Starting pre-flight checks enquanto o MongoDB Ops Manager atualiza todos os seus servidores para a mesma versão.
[Opcional] Repita as etapas anteriores para todos os outros hosts do Ops Manager em sua implantação de Alta Disponibilidade.
Faça login no host do MongoDB Ops Manager que você atualizou depois que ele for reiniciado. Se seu login for bem-sucedido, a atualização foi bem-sucedida.
Se seu login foi bem-sucedido, repita essas etapas no próximo host em sua implantação de alta disponibilidade MongoDB Ops Manager .
Atualizar todos os Agentes.
Assim que a atualização for concluída, faça login na instância do Ops Manager. O Ops Manager exibe um banner que diz One or more agents are out of date.
Clique em Update All Agents e confirme as alterações.
Importante
Se o Ops Manager gerenciar suas ferramentas do MongoDB, as versões das ferramentas serão atualizadas com os agentes.
Se o gerente de operações gerenciar seu conector de BI, a versão do conector de BI será atualizada com os agentes.
Use este procedimento para atualizar sistemas Linux que não usam pacotes deb ou rpm .
Faça backup dos arquivos de configuração no host do MongoDB Ops Manager .
No host do MongoDB Ops Manager que você está atualizando, faça backup dos arquivos e registros de configuração existentes em um diretório diferente do diretório de instalação.
Importante
Você precisa do arquivo <install_dir>/conf/conf-mms.properties de backup para utilizar mais tarde neste procedimento.
Exemplo
Os comandos a seguir fazem backup dos arquivos de configuração e registram-se no seu diretório inicial:
cp -a <install_dir>/conf ~/mms_conf.backup cp -a <install_dir>/logs ~/mms_logs.backup
Se o Versions Directory estiver em <install_dir> , faça backup dele.
cp -a <install_dir>/mongodb-releases ~/mms_versions.backup
Você também deve fazer backup do arquivo gen.key que o MongoDB Ops Manager usa para criptografar e descriptografar os bancos de dados de backup e as credenciais de usuário MongoDB Ops Manager. MongoDB Ops Manager requer um arquivo gen.key idêntico em cada servidor que faz parte de uma implantação MongoDB Ops Manager altamente disponível.
Baixe a versão mais recente do pacote Ops Manager.
Abra seu navegador preferido para visitar o MongoDB Download Center em MongoDB.com.
Se começar a partir de MongoDB.com, clique em Products Ops Manager Try it now.
No menu suspenso Version , clique em uma das versões estáveis fornecidas.
No menu suspenso Platform, clique em uma das seguintes opções:
Red Hat + CentOS 7, 8, 9 / SUSE 12 + 15 / Amazon Linux 2, Amazon Linux 2023
Debian 9, 10, 11 / Ubuntu 18.04
No menu suspenso Package, clique em tar.gz.
Clique em Download.
O pacote baixado é denominado
mongodb-mms-<version>.x86_64.tar.gz, onde<version>é o número da versão.
Instale o pacote MongoDB Ops Manager em cada host que você está atualizando.
Observação
Modo de Atualização para Aplicativos do Ops Manager Altamente Disponíveis
Se você tiver uma instalação do Ops Manager 4.4 com mais de um host do Ops Manager apontando para o mesmo aplicativo de banco de dados, este sistema do Ops Manager será executado com alta disponibilidade. Depois de atualizar um host do Ops Manager de um sistema do Ops Manager altamente disponível, esse sistema entra no Modo de atualização.
Navegue até o diretório no qual você deseja instalar o MongoDB Ops Manager. Extraia o arquivo para esse diretório:
tar -zxf mongodb-mms-<version>.x86_64.tar.gz
Importante
Para instalar uma nova versão no mesmo diretório da versão antiga, siga estas etapas:
Renomeie o diretório de instalação atual.
mv <install_dir> <install_dir_old> Crie um novo diretório com o nome original do seu diretório antigo.
mkdir <install_dir>
Isso evita um diretório de instalação vazio e conflitos de biblioteca de código.
Em cada host MongoDB Ops Manager , restaure os registros de backup e os arquivos de configuração no diretório de instalação do MongoDB Ops Manager .
Todos os arquivos de log devem ser restaurados. A maioria, mas não todos, os arquivos de configuração devem ser restaurados. Restaurar:
conf-mms.properties- As configurações para esta implantação MongoDB Ops Manager .
gen.key- A chave de criptografia para os bancos de dados de backup desta implantação do MongoDB Ops Manager .
Exemplo
Esses comandos restauram os arquivos de configuração e os registros do seu diretório inicial:
cp -a ~/mms_logs.backup <install_dir>/logs cp -a ~/mms_conf.backup/conf-mms.properties <install_dir>/conf/conf-mms.properties cp -a ~/mms_conf.backup/gen.key <install_dir>/conf/gen.key
Se você fez backup do Versions Directory anteriormente, restaure-o para <install_dir>.
cp -a ~/mms_versions.backup <install_dir>/mongodb-releases.
Observação
Em instâncias de alta disponibilidade do Ops Manager, o Backup Daemon espera que todos os nós atualizem antes de iniciar.
Opcional. Em cada servidor do Ops Manager, mescle todas as alterações necessárias no mms.conf arquivo a partir do seu backup.
O arquivo mms.conf raramente é personalizado, pois contém definições de configuração de porta e JVM . Se você modificou as portas ou as configurações de JVM que o MongoDB Ops Manager usa, precisará reaplicar essas alterações da cópia de backup ao arquivo mms.conf depois que o MongoDB Ops Manager for atualizado.
Aviso
Não adicione senhas ou segredos aos argumentos JVM no arquivo mms.conf . MongoDB Ops Manager os expõe como texto simples nos arquivos de diagnóstico.
A atualização para o Ops Manager 4.1 e 4.2 removeu o sinalizador -d64 do parâmetro JAVA_MMS_UI_OPTS.
[Opcional] Repita as etapas anteriores para todos os outros hosts do Ops Manager em sua implantação de Alta Disponibilidade.
Faça login no host do MongoDB Ops Manager que você atualizou depois que ele for reiniciado. Se seu login for bem-sucedido, a atualização foi bem-sucedida.
Se seu login foi bem-sucedido, repita essas etapas no próximo host em sua implantação de alta disponibilidade MongoDB Ops Manager .
Atualizar todos os Agentes.
Assim que a atualização for concluída, faça login na instância do Ops Manager. O Ops Manager exibe um banner que diz One or more agents are out of date.
Clique em Update All Agents e confirme as alterações.
Importante
Se o Ops Manager gerenciar suas ferramentas do MongoDB, as versões das ferramentas serão atualizadas com os agentes.
Se o gerente de operações gerenciar seu conector de BI, a versão do conector de BI será atualizada com os agentes.
Solução de problemas
Opção de VM não Reconhecida
A saída da verificação pré-voo ou o log de inicialização devem incluir um erro como Unrecognized VM option 'UseParNewGC'. Esse erro pode ocorrer se algum dos seguintes arquivos tiver sido editado:
/etc/rc.d/init.d/mongodb-mmsmms.confconf-mms.properties
Remova -XX:+UseParNewGC dos arquivos de configuração para resolver esse problema.
Alterações nas definições de configuração
Dependendo da distribuição do Linux e das configurações locais, o Ops Manager poderá substituir as alterações feitas no arquivo de configuração durante a atualização. No Ops Manager 5,0 e posterior, se você usar pacotes RPM, o Ops Manager não atualizará mais o arquivo de configuração após a atualização. Se uma nova versão do Ops Manager exigir novas propriedades no arquivo de configuração, você deverá adicioná-las ao arquivo após a atualização.
Ao atualizar, atualize o valor do mongo.mongoUri para incluir os novos parâmetros introduzidos com o MongoDB Java driver. Por padrão, esse driver permite leituras e gravações repetíveis. Se você definir lógica personalizada para tentar ler e gravar novamente, as tentativas podem levar muito tempo. Para desabilitar esses valores padrão, adicione o seguinte à sua string de conexão:
Exemplo
mongodb://SERVER:PORT/?maxPoolSize=150&retryWrites=false&retryReads=false
Opção de VM não Reconhecida
A saída da verificação pré-voo ou o log de inicialização devem incluir um erro como Unrecognized VM option 'UseParNewGC'. Esse erro pode ocorrer se algum dos seguintes arquivos tiver sido editado:
/etc/rc.d/init.d/mongodb-mmsmms.confconf-mms.properties
Remova -XX:+UseParNewGC dos arquivos de configuração para resolver esse problema.
Alterações nas definições de configuração
Dependendo da distribuição do Linux e das configurações locais, o Ops Manager poderá substituir as alterações feitas no arquivo de configuração durante a atualização. No Ops Manager 5,0 e posterior, se você usar pacotes RPM, o Ops Manager não atualizará mais o arquivo de configuração após a atualização. Se uma nova versão do Ops Manager exigir novas propriedades no arquivo de configuração, você deverá adicioná-las ao arquivo após a atualização.
Opção de VM não Reconhecida
A saída da verificação pré-voo ou o log de inicialização devem incluir um erro como Unrecognized VM option 'UseParNewGC'. Esse erro pode ocorrer se algum dos seguintes arquivos tiver sido editado:
/etc/rc.d/init.d/mongodb-mmsmms.confconf-mms.properties
Remova -XX:+UseParNewGC dos arquivos de configuração para resolver esse problema.
Alterações nas definições de configuração
Dependendo da distribuição do Linux e das configurações locais, o Ops Manager poderá substituir as alterações feitas no arquivo de configuração durante a atualização. No Ops Manager 5,0 e posterior, se você usar pacotes RPM, o Ops Manager não atualizará mais o arquivo de configuração após a atualização. Se uma nova versão do Ops Manager exigir novas propriedades no arquivo de configuração, você deverá adicioná-las ao arquivo após a atualização.
Ao atualizar, atualize o valor do mongo.mongoUri para incluir os novos parâmetros introduzidos com o MongoDB Java driver. Por padrão, esse driver permite leituras e gravações repetíveis. Se você definir lógica personalizada para tentar ler e gravar novamente, as tentativas podem levar muito tempo. Para desabilitar esses valores padrão, adicione o seguinte à sua string de conexão:
Exemplo
mongodb://SERVER:PORT/?maxPoolSize=150&retryWrites=false&retryReads=false
Acesso Reflexivo Ilegal
Este aviso é exibido devido à versão da bibliotecaGuice que MongoDB Ops Manager o usa. Você pode ignorar esse aviso com segurança.