Você pode usar a API do Ops Manager para desligar, iniciar, reiniciar e ressincronizar um processo do MongoDB. Essas operações são úteis durante testes de resiliência para simular períodos de inatividade ou para reinicializações planejadas para manutenção. Você também pode ressincronizar um membro que ficou muito atrasado após uma longa inatividade.
Ao enviar uma solicitação, o Ops Manager instrui imediatamente o Agente de Automação em execução nesse host a desligar, iniciar, reiniciar ou ressincronizar o processo do MongoDB. O agente aplica a alteração em sua próxima comunicação com o Ops Manager. Se o processo for o primário atual, o agente primeiro o desativa para que outro membro possa assumir o controle e, em seguida, o interrompe ou reinicia.
Sobre esta tarefa
Each operation is asynchronous. A
200 OKresponse means Ops Manager published the change, not that the process has stopped, started, restarted, or resynced. The response includes no job ID. To follow the change to completion, poll the automation status resource. If the agent can't apply the change, the plan shows as failed there and the agent keeps retrying.Every endpoint accepts an optional
dryRun=truequery parameter. Use it to preview a change before you apply it. Ops Manager runs all the same checks and returns the process document as it would look after the change, but sends nothing to the agent and changes nothing in your deployment. For example, after a shutdown the returned document contains"disabled": true. Review it, then send the same request withoutdryRun=trueto apply the change.
Antes de começar
Your deployment must run Ops Manager 8.0.28 or 9.0.2 or later.
A automação deve estar habilitada para o projeto e o Agente de Automação do host de destino deve estar em execução.
Se você tiver um rascunho de configuração de automação não publicado no projeto, o Ops Manager rejeitará todas as solicitações, incluindo uma simulação. Publique ou descarte o rascunho antes de continuar.
You must have the
Project Automation Adminrole.Esses endpoints não são compatíveis com projetos gerenciados externamente nem com implantações do Kubernetes Operator (MCK).
Aviso
Esses endpoints não oferecem proteção de quorum. Desativar muitos membros de um conjunto de réplicas o deixa sem um primário. Desative os membros um de cada vez e aguarde a conclusão de cada um antes de prosseguir.
Desligar um processo
Este procedimento interrompe um processo em execução de forma controlada.
Encontre o nome do host e a porta do processo.
Find the hostname:port of the process in the Ops Manager UI or with the v2.0 Get All Hosts endpoint.
Consulte o endpoint de status da automação.
Poll the automation status resource until the process's lastGoalVersionAchieved equals the plan's goalVersion.
A tabela a seguir descreve como o Ops Manager lida com solicitações de desligamento em cenários específicos.
Cenário | Comportamento |
|---|---|
A Target é a principal atual | O agente diminui a velocidade antes de desligá-lo. |
A Target já fechou. | Nenhuma alteração no processo. O agente não executa nenhuma ação, mas o Ops Manager ainda publica a configuração e registra o evento. |
O alvo está em modo manual. | Ops Manager rejects the request with |
Iniciar um processo
Este procedimento inicia um processo que havia sido previamente encerrado.
Encontre o nome do host e a porta do processo.
Find the hostname:port of the process in the Ops Manager UI or with the v2.0 Get All Hosts endpoint.
Confirme se o membro retornou a um estado saudável.
Poll the automation status resource until the plan completes. Then confirm that the member's replicaStateName on the v2.0 Get One Host by ID endpoint returns to SECONDARY or PRIMARY.
A tabela a seguir descreve como o Ops Manager lida com solicitações de inicialização em cenários específicos.
Cenário | Comportamento |
|---|---|
O alvo já está em execução. | Nenhuma alteração no processo. O agente não executa nenhuma ação, mas o Ops Manager ainda publica a configuração e registra o evento. |
O oplog foi reiniciado enquanto o processo estava inativo. | The member starts and stays in |
Reiniciar um processo
Este procedimento reinicia um processo em execução de forma controlada. Se o alvo for o processo primário atual, o agente o desativa antes de reiniciá-lo.
Encontre o nome do host e a porta do processo.
Find the hostname:port of the process in the Ops Manager UI or with the v2.0 Get All Hosts endpoint.
Consulte o endpoint de status da automação.
Monitore o status do recurso de automação até que o plano seja concluído.
A tabela a seguir descreve como o Ops Manager lida com solicitações de reinicialização em cenários específicos.
Cenário | Comportamento |
|---|---|
A Target está fechada. | Ops Manager rejects the request with |
O agente do host de destino nunca se reportou ao Gerente de Operações. | Ops Manager rejects the request with |
Ressincronizar um processo
This procedure triggers an initial sync on a replica set member. Use it to recover a member stuck in RECOVERING because it fell behind the oplog window.
Encontre o nome do host e a porta do processo.
Find the hostname:port of the process in the Ops Manager UI or with the v2.0 Get All Hosts endpoint.
Confirme se o membro concluiu a sincronização inicial.
Poll the automation status resource until the plan completes. Then poll v2.0 Get One Host by ID until replicaStateName is SECONDARY. The initial sync can take a long time on large data sets.
A tabela a seguir descreve como o Ops Manager lida com solicitações de ressincronização em cenários específicos.
Cenário | Comportamento |
|---|---|
The target is a | Ops Manager rejects the request with |
Outro membro do conjunto de réplicas já tem uma resincronização pendente. | Ops Manager rejects the request with |
O alvo é o atual primário | Ops Manager returns |
O agente do host de destino nunca se reportou ao Gerente de Operações. | Ops Manager rejects the request with |
Trilha de auditoria
Cada solicitação bem-sucedida, que não seja um teste, adiciona um evento ao feed de atividades do projeto, além do evento de publicação da configuração de automação usual. O feed de atividades atribui as solicitações feitas com a API à API Pública.
(operação) | Tipo de evento | O que ele diz a você |
|---|---|---|
Desligar |
| Foi feita uma solicitação de encerramento para este processo. Verifique este evento se um membro ficou offline inesperadamente. |
Iniciar |
| Foi feita uma solicitação para iniciar um processo que havia sido interrompido. |
Reiniciar |
| Foi feita uma solicitação de reinicialização para este processo. Verifique este evento se um membro se ausentou brevemente ou se ocorreu uma eleição. |
Ressincronizar |
| A resync request was made for this process. Check this event if a member went into |
Solução de problemas
A tabela a seguir descreve os erros e sintomas comuns que ocorrem ao usar os endpoints do ciclo de vida do processo.
Problema | Provável Causa | de conflitos |
|---|---|---|
| Você tem um rascunho de configuração de automação não publicado no projeto. | Publique ou descarte o rascunho e tente novamente. |
| Alguém publicou uma alteração entre o Ops Manager lendo e publicando a configuração. | Tente novamente. |
| O projeto está se reconciliando após uma restauração. | Aguarde a conclusão da reconciliação e tente novamente. |
| O agente do host de destino nunca se reportou ao Gerente de Operações. | Confirme se o agente está instalado, em execução e consegue se conectar ao Ops Manager. Em seguida, tente novamente. |
| Os processos do projeto são gerenciados por um sistema externo. | Esses endpoints não se aplicam a projetos gerenciados externamente. |
|
| Confirm the value with v2.0 Get All Hosts, then retry. |
| O processo foi encerrado. | Em vez disso, chame o endpoint de inicialização. |
| Uma resincronização para este conjunto de réplicas já foi solicitada e a implantação ainda não atingiu o estado desejado. Uma resincronização travada, por exemplo, uma solicitada em um servidor primário, continua bloqueando novas solicitações. | Monitore o status do recurso de automação até que o plano seja concluído e, em seguida, tente novamente. |
| The target is a | Em vez disso, resincronize um membro do conjunto de réplicas que contenha dados. |
|
| Corrija o valor ou omita o parâmetro. |
Após a ressincronização, o status da automação indica que é necessária intervenção manual. | A resincronização foi solicitada em um servidor primário. | Reduza a prioridade do processo primário para desbloquear a ressincronização. |
O plano continua falhando no status de automação. | O agente não consegue aplicar a alteração, por exemplo, porque o host está inacessível. | Analise o erro do processo na resposta de status da automação e corrija a causa. O agente tentará novamente. |
Member stays in | O oplog foi sobrescrito enquanto o processo estava inativo, então o membro não conseguiu recuperar o atraso. | Resync the process, then check |