Redémarrage du cluster ou Maintenance planifiée du cluster Omnissa Access

Après un redémarrage du nœud, celui-ci ne rejoint pas automatiquement le cluster Omnissa Access. Vous devez exécuter wso cp unseal à partir du nœud de démarrage pour restaurer l'appartenance au cluster.

Remarque : ce comportement s'applique uniquement à la build provisoire actuelle.

Utilisez l'option de procédure appropriée ci-dessous en fonction de votre scénario de maintenance.

Option 1 - Maintenance planifiée : redémarrer un nœud à la fois

Redémarrez un nœud à la fois pour maintenir la disponibilité du cluster. Le cluster reste fonctionnel à une capacité dégradée pendant le redémarrage.

Nœuds Omnissa Access

1. Arrêtez le nœud à maintenir.

2. Surveillez la santé et l'état du service du cluster.

   Le cluster doit rester sain avec une instance de chaque service s'exécutant à une capacité réduite.

3. Terminez la maintenance et remettez le nœud en ligne.

4. À partir du nœud de démarrage, exécutez :

   wso cp unseal
   

5. À partir du nœud de démarrage, exécutez la commande suivante pour vérifier la santé du cluster.

   Prévoyez un temps pour que tous les services reviennent en ligne :

   wso healthcheck
   

6. Vérifiez que les deux instances sont en cours d'exécution.

7. Exécutez la commande suivante pour confirmer que tous les services sont prêts à servir le trafic :

   wso access check-service-readiness
   

Si les deux nœuds d'accès tombent en panne (imprévu) :

1. Une fois que les deux nœuds sont à nouveau en ligne, exécutez la commande suivante à partir du nœud de démarrage :

   wso cp unseal
   

2. Exécutez wso healthcheck à partir du nœud de démarrage et laissez à tous les services le temps de revenir en ligne.
3. Vérifiez que les deux instances sont en cours d'exécution.
4. Exécutez wso access check-service-readiness pour confirmer que les services sont prêts à servir le trafic.

Nœuds d'infrastructure/de plate-forme

Redémarrez un nœud à la fois. Les services d'infrastructure (PostgreSQL, Kafka, Redis et OpenSearch) restent fonctionnels avec deux instances lors du redémarrage.

1. Arrêtez le nœud à maintenir.

2. Surveiller la santé du cluster.

   Le cluster doit rester fonctionnel avec deux instances de chaque service d'infrastructure.

3. Terminez la maintenance et remettez le nœud en ligne.

4. À partir du nœud de démarrage, exécutez :

   wso cp unseal
   

5. À partir du nœud de démarrage, exécutez wso healthcheck pour vérifier la santé du cluster.

   Prévoyez un temps pour que tous les services reviennent en ligne.

6. Vérifiez que les trois instances de chaque service d'infrastructure sont en cours d'exécution.

Si tous les nœuds d'infrastructure/de plate-forme tombent en panne (imprévu) :

1. Une fois que tous les nœuds sont à nouveau en ligne, exécutez la commande suivante à partir du nœud de démarrage :

   wso cp unseal
   

2. Exécutez wso healthcheck à partir du nœud de démarrage et laissez aux services le temps de revenir en ligne.
3. Vérifiez que les trois instances de chaque service d'infrastructure sont en cours d'exécution.

Redémarrer le nœud de démarrage

Le redémarrage du nœud de démarrage n'affecte pas les services de cluster. Le nœud de démarrage est uniquement responsable de l'initialisation du cluster et n'exécute pas de services critiques.

Option 2 - Maintenance planifiée : sans performances dégradées (nœud tampon)

Pour effectuer la maintenance sans dégradation du service, ajoutez un nœud tampon temporaire avant de commencer. Cela permet aux services hors du nœud de migrer en cours de maintenance.

1. Déployez un nouveau nœud avec la même configuration que les nœuds existants et ajoutez-le au cluster.

2. À partir du nœud de démarrage, mettez à jour cp-cluster.ini avec l'adresse IP du nouveau nœud et exécutez :

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

3. Purgez le nœud à maintenir à partir de l'UI Nomad (Clients > sélectionner un nœud > Purger).

   Cette action migre tous les services vers d'autres nœuds, y compris le nœud tampon, sans incidence sur les performances.

4. Effectuez la maintenance sur les nœuds existants à tour de rôle.

5. Une fois la maintenance terminée, supprimez éventuellement le nœud tampon en supprimant son entrée de cp-cluster.ini et en l'arrêtant.

   Vous pouvez également le conserver en tant que nœud en veille pour une maintenance ultérieure.

6. À partir du nœud de démarrage, exécutez :

   wso cp unseal
   

7. Exécutez wso healthcheck pour vérifier la santé du cluster.

8. Vérifiez que les deux instances de chaque service Access et que les trois instances de chaque service d'infrastructure/de plate-forme sont en cours d'exécution.

9. Exécutez wso access check-service-readiness pour confirmer que tous les services sont prêts à servir le trafic.

   Remarque : après le redémarrage d'un nœud et wso cp unseal, laissez le temps à tous les services de revenir en ligne et de former un cluster sain. Surveiller la santé du cluster pendant cette période. Si la récupération d'un service échoue, vérifiez ses journaux dans l'UI Nomad, purgez le service et redéployez-le :

   wso services deploy -s <service-name>