Procédure correcte d’arrêt du système VergeOS

Guide complet étape par étape pour arrêter en toute sécurité les systèmes et clusters VergeOS, y compris l’arrêt des charges de travail locataires, la séquence multi-clusters et les procédures correctes de mise sous tension.

Vue d’ensemble

Ce document fournit la procédure étape par étape pour arrêter correctement un système VergeOS. Suivre la bonne séquence d’arrêt est essentiel pour garantir l’intégrité des données, prévenir toute corruption et maintenir la santé de votre environnement VergeOS.

Prérequis

• Accès administratif à l’interface VergeOS

• Compréhension de la topologie de votre cluster

• Identification de toutes les charges de travail et de tous les locataires en cours d’exécution

• Connaissance de l’emplacement des nœuds contrôleurs (Node1 et Node2)

Séquence d’arrêt

Étape 1 : Inventorier les charges de travail en cours d’exécution

Avant de commencer le processus d’arrêt, vous devez identifier toutes les charges de travail actives dans votre environnement.

1. Accédez à chaque Tableau de bord du nœud dans votre cluster

2. Consultez les Machines en cours d’exécution section sur chaque nœud

3. Documentez toutes les charges de travail en cours d’exécution, notamment :

   • Machines virtuelles (VM)

   • Nœuds locataires

   • Services de sauvegarde VMware

   • Services NAS

   • Tout autre service actif

Étape 2 : Arrêter les charges de travail des locataires

Si des locataires s’exécutent sur un ou plusieurs nœuds de votre cluster :

1. Connectez-vous à chaque environnement locataire qui dispose de charges de travail actives

2. Arrêtez proprement toutes les charges de travail en cours d’exécution au sein de chaque locataire

3. Vérifiez que l’arrêt est terminé avant de passer à l’étape suivante

Important

Assurez-vous que toutes les charges de travail des locataires sont correctement arrêtées avant de continuer. Le non-respect de cette consigne peut entraîner une perte ou une corruption des données.

Étape 3 : Mettre hors tension les charges de travail au niveau des hôtes

Une fois que toutes les charges de travail des locataires sont arrêtées, mettez hors tension toutes les charges de travail restantes sur chaque nœud :

1. Machines virtuelles (VM): Utilisez l’option d’arrêt gracieux lorsque cela est possible

2. Nœuds locataires: Assurez-vous qu’ils sont mis hors tension après leurs charges de travail internes

3. Services de sauvegarde VMware: Arrêtez toute opération de sauvegarde active

4. Services NAS: Arrêtez en toute sécurité tous les services liés au NAS

5. Autres services: Mettez hors tension tout autre service actif restant

Conteneurs vNet

Les conteneurs vNet n’ont pas besoin d’être arrêtés manuellement. Ils seront arrêtés proprement automatiquement pendant le processus d’arrêt du cluster.

Étape 4 : Arrêter les nœuds individuellement

Une fois que toutes les charges de travail sont arrêtées :

1. Accédez au Tableau de bord du cluster pour le cluster que vous souhaitez mettre hors tension

2. Sélectionnez Mettre hors tension dans le menu de gauche

3. Le système commencera à arrêter chaque nœud du cluster

4. Surveillez la progression de l’arrêt via le tableau de bord du cluster

Étape 5 : Arrêter l’ensemble du cluster

Une fois les nœuds individuels arrêtés :

1. Accédez à Système → Clusters

2. Sélectionnez le cluster que vous voulez arrêter

3. Sélectionnez Mettre hors tension dans le menu de gauche

4. Confirmez l’arrêt lorsque vous y êtes invité

Considérations pour les environnements multi-clusters

Avertissement critique

Si votre environnement contient plusieurs clusters, vous devez TOUJOURS arrêter le cluster contenant les nœuds contrôleurs (Node1 et Node2) EN DERNIER.

Ordre d’arrêt pour les environnements multi-clusters :

1. Arrêtez d’abord tous les clusters non contrôleurs en premier

2. Arrêtez le cluster contrôleur (contenant Node1 et Node2) en dernier

Cela garantit que les services de coordination et de gestion du cluster restent disponibles jusqu’à ce que tous les autres clusters soient arrêtés en toute sécurité.

Méthode alternative : arrêt via l’API

Pour les utilisateurs avancés ou à des fins d’automatisation, vous pouvez utiliser l’API VergeOS pour arrêter des clusters :

POST /v4/cluster_actions
{
    "cluster": [cluster_id],
    "action": "shutdown",
    "params": "{}"
}

Séquence correcte de mise sous tension

Lorsque vous remettez votre système VergeOS sous tension, suivez cette séquence :

Environnement à cluster unique :

1. Mettez Node1 sous tension en premier

2. Attendez que Node1 soit en ligne complètement

3. Mettez Node2 sous tension

4. Mettez sous tension les nœuds restants un par un, en attendant environ 1 minute entre chacun

5. Vérifiez l’état du système sur le tableau de bord principal (doit afficher Vert et En ligne)

Environnement multi-clusters :

1. Mettez d’abord le cluster contrôleur sous tension (Node1, puis Node2, puis les autres nœuds contrôleurs)

2. Attendez que le cluster contrôleur soit entièrement en ligne

3. Mettez sous tension les autres clusters en suivant la séquence du cluster unique pour chacun

Vérification et surveillance

Après avoir terminé le processus d’arrêt ou de démarrage :

1. Consultez le tableau de bord principal pour les indicateurs d’état du système

2. Vérifiez que tous les nœuds affichent l’état approprié (Hors ligne pour l’arrêt, En ligne pour le démarrage)

3. Surveillez les journaux du système pour détecter toute erreur ou avertissement

4. Testez les services critiques après le démarrage afin de vous assurer du bon fonctionnement

Dépannage

Problèmes courants lors de l’arrêt :

Les charges de travail ne s’arrêtent pas proprement :

• Vérifiez les paramètres ACPI du système d’exploitation invité

• Utilisez les options "Réinitialisation matérielle" ou "Couper l’alimentation" en dernier recours

• Passez en revue les paramètres de gestion de l’alimentation de la VM

Les nœuds ne passent pas à l’arrêt :

• Vérifiez que toutes les charges de travail sont arrêtées

• Vérifiez s’il existe des VM bloquées ou ne répondant pas

• Consultez les journaux du nœud pour trouver des messages d’erreur

L’arrêt du cluster échoue :

• Assurez-vous d’abord que les nœuds individuels sont correctement arrêtés

• Vérifiez l’état du cluster et la connectivité

• Vérifiez qu’aucune migration ou opération de maintenance n’est active

Obtenir de l’aide :

Si vous rencontrez des problèmes pendant le processus d’arrêt :

1. Documentez les messages d’erreur et l’état actuel du système

2. Consultez les journaux VergeOS pour obtenir des informations détaillées sur l’erreur

3. Contactez le support VergeOS avec des détails précis sur le problème

Bonnes pratiques

• Planifiez les fenêtres d’arrêt pendant les périodes de faible utilisation

• Informez les utilisateurs avant de commencer les procédures d’arrêt

• Documentez votre environnement spécifique y compris la topologie du cluster et les charges de travail critiques

• Testez le processus d’arrêt d’abord dans des environnements hors production

• Conservez des sauvegardes à jour avant d’effectuer des arrêts du système

• Utilisez le mode maintenance pour les nœuds individuels lorsque cela est possible, au lieu d’arrêts complets

Liste de contrôle récapitulative

• Inventoriez toutes les charges de travail en cours d’exécution sur tous les nœuds

• Arrêtez proprement les charges de travail des locataires

• Mettez hors tension toutes les charges de travail au niveau des hôtes (VM, services, etc.)

• Accédez à Tableau de bord du cluster et sélectionnez Mettre hors tension

• Accédez à Système → Clusters et mettez hors tension l’ensemble du cluster

• Pour plusieurs clusters : arrêtez le cluster contrôleur (Node1 et Node2) EN DERNIER

• Vérifiez la fin de l’arrêt via la surveillance du tableau de bord

• Documentez tout problème rencontré pour référence future

Le respect de cette procédure garantit un arrêt sûr et maîtrisé de votre environnement VergeOS tout en préservant l’intégrité des données et la santé du système.

---

Informations sur le document

• Type de document : Article de base de connaissances

• Catégorie : Administration système

• Mots-clés : arrêt, mise hors tension, gestion de cluster, maintenance du système

• S’applique à : VergeOS 4.12.6 et versions ultérieures