> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/fr/system-administration/proper-vergeos-system-shutdown-procedure.md).

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

## 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

{% hint style="warning" %}
**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.
{% endhint %}

### É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

{% hint style="info" %}
**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.
{% endhint %}

### É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

{% hint style="danger" %}
**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**.
{% endhint %}

### 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 :

```json
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.

***

{% hint style="info" %}
**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
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/knowledge-base/fr/system-administration/proper-vergeos-system-shutdown-procedure.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.