Reinicialização do cluster ou manutenção planejada do cluster do Omnissa Access

Após qualquer reinicialização do nó, o nó não reingessa automaticamente ao cluster do Omnissa Access. Você deve executar wso cp unseal no nó de bootstrap para restaurar a associação ao cluster.

Nota: esse comportamento se aplica apenas à compilação provisória atual.

Use a opção de procedimento apropriada abaixo com base no seu cenário de manutenção.

Opção 1 – Manutenção planejada: reinicializar um nó de cada vez

Reinicie um nó de cada vez para manter a disponibilidade do cluster. O cluster permanece funcional com capacidade degradada durante a reinicialização.

Nós do Omnissa Access

1. Desative o nó a ser submetido à manutenção.

2. Monitore a integridade do cluster e o status dos serviços.

   O cluster deve permanecer íntegro, com uma instância de cada serviço em execução com capacidade reduzida.

3. Conclua a manutenção e coloque o nó online novamente.

4. No nó de bootstrap, execute:

   wso cp unseal
   

5. No nó de bootstrap, execute o seguinte comando para verificar a integridade do cluster.

   Aguarde até que todos os serviços voltem a ficar online:

   wso healthcheck
   

6. Verifique se duas instâncias de cada serviço estão em execução.

7. Execute o seguinte comando para confirmar se todos os serviços estão prontos para atender ao tráfego:

   wso access check-service-readiness
   

Se ambos os nós do Access forem desativados (não planejado):

1. Assim que ambos os nós estiverem novamente online, execute o seguinte comando a partir do nó de bootstrap:

   wso cp unseal
   

2. Execute wso healthcheck do nó de bootstrap e aguarde até que todos os serviços voltem a ficar online.
3. Verifique se duas instâncias de cada serviço estão em execução.
4. Execute wso access check-service-readiness para confirmar se os serviços estão prontos para atender ao tráfego.

Nós de infraestrutura/plataforma

Reinicie um nó por vez. Os serviços de infraestrutura (PostgreSQL, Kafka, Redis e OpenSearch) permanecem funcionais com duas instâncias durante a reinicialização.

1. Desative o nó a ser submetido à manutenção.

2. Monitore a integridade do cluster.

   O cluster deve permanecer funcional com duas instâncias de cada serviço de infraestrutura.

3. Conclua a manutenção e coloque o nó online novamente.

4. No nó de bootstrap, execute:

   wso cp unseal
   

5. No nó de bootstrap, execute wso healthcheck para verificar a integridade do cluster.

   Aguarde até que todos os serviços voltem a ficar online.

6. Verifique se três instâncias de cada serviço de infraestrutura estão em execução.

Se todos os nós de infraestrutura/plataforma forem desativados (não planejado):

1. Assim que todos os nós estiverem novamente online, execute o seguinte comando a partir do nó de bootstrap:

   wso cp unseal
   

2. Execute wso healthcheck do nó de bootstrap e aguarde até que os serviços voltem a ficar online.
3. Verifique se três instâncias de cada serviço de infraestrutura estão em execução.

Reinicialização do nó de bootstrap

A reinicialização do nó de bootstrap não afeta os serviços do cluster. O nó de bootstrap é responsável apenas pela inicialização do cluster e não executa serviços críticos.

Opção 2 – Manutenção planejada: sem degradação de desempenho (nó buffer)

Para realizar a manutenção sem degradação do serviço, adicione um nó buffer temporário antes de começar. Isso permite que os serviços sejam migrados para fora do nó que está sendo mantido.

1. Implante um novo nó com a mesma configuração dos nós existentes e adicione-o ao cluster.

2. No nó de bootstrap, atualize cp-cluster.ini com o novo IP do nó e execute:

   wso cp deploy -t <new-node-ip>
   

3. Drene o nó a ser mantido na UI do Nomad (Clientes > selecione nó > Esvaziar).

   Essa ação migra todos os serviços para outros nós, incluindo o nó de buffer, sem impacto no desempenho.

4. Realize a manutenção nos nós existentes, um de cada vez.

5. Após a conclusão da manutenção, opcionalmente remova o nó de buffer excluindo sua entrada de cp-cluster.ini e desativando-o.

   Você também pode mantê-lo como um nó de reserva para futuras manutenções.

6. No nó de bootstrap, execute:

   wso cp unseal
   

7. Execute wso healthcheck para verificar a integridade do cluster.

8. Verifique se duas instâncias de cada serviço do Access e três instâncias de cada serviço de Infraestrutura/Plataforma estão em execução.

9. Execute wso access check-service-readiness para confirmar se todos os serviços estão prontos para atender ao tráfego.

   Nota: após uma reinicialização do nó e wso cp unseal, permita que todos os serviços voltem a ficar online e formem um cluster íntegro. Monitore a integridade do cluster durante esse período. Se a recuperação de um serviço falhar, verifique seus logs na UI do Nomad, limpe o serviço e reimplante-o:

   wso services deploy -s <service-name>