> 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/learn-the-platform/fr/module-9-supervision-et-depannage/06-common-issues.md).

# Problèmes courants et résolutions

Modèles de dépannage pour les problèmes VergeOS les plus fréquemment rencontrés — réseau des VM, remontée de la mémoire invité, bruit SEL, partages NAS, problèmes d’installation et dégradation du stockage.

## Référence rapide de dépannage

Cette page compile les problèmes les plus courants rencontrés par les administrateurs VergeOS, organisés par sous-système. Chaque section comprend les symptômes, les causes profondes et des procédures de résolution étape par étape.

```mermaid
graph TD
    A["Identifier le symptôme"] --> B{"Quel sous-système ?"}
    B -->|VM| C["Réseau / Mémoire"]
    B -->|Stockage| D["vSAN / NAS"]
    B -->|Matériel| E["SEL / IPMI"]
    B -->|Installation| F["Démarrage / Jonction"]

    C --> G["Étapes de résolution"]
    D --> G
    E --> G
    F --> G
    G --> H{"Résolu ?"}
    H -->|Oui| I["Documenter et clôturer"]
    H -->|Non| J["Escalader au support"]

    style A fill:#4a90d9,color:#fff
    style B fill:#2c3e50,color:#fff
    style G fill:#27ae60,color:#fff
    style J fill:#e74c3c,color:#fff
```

***

## Connectivité réseau des VM

Les problèmes de connectivité réseau sont le sujet de support le plus courant. Avant d'aller plus loin, vérifiez si **d'autres VM** dans le même environnement peuvent accéder à Internet. Si aucune ne le peut, le problème vient probablement d'une couche située en amont de VergeOS (commutateur, pare-feu, FAI). Si les autres VM fonctionnent correctement, le problème est presque toujours une configuration manquante sur la VM concernée.

### Configuration NIC manquante

**Symptôme :** La VM démarre mais aucune interface réseau n'est visible dans le système d'exploitation invité.

**Résolution :**

1. Ouvrez le tableau de bord de la VM et vérifiez la **cartes réseau** section
2. Si aucune NIC n'est répertoriée, cliquez sur **Ajouter une NIC**
3. Sélectionnez le bon réseau et définissez le type d'interface sur **VirtIO** (recommandé) ou **E1000** pour la compatibilité avec les anciens systèmes
4. La NIC apparaît immédiatement dans l'invité lorsque le hot-plug est activé (par défaut) — un rescannage du système d'exploitation invité peut être nécessaire sur certains systèmes d'exploitation. N'effectuez un cycle d'alimentation que si le hot-plug est désactivé.

### Affectation de réseau incorrecte

**Symptôme :** La VM possède une NIC mais ne peut pas atteindre les autres VM ni Internet.

**Résolution :**

1. Accédez au tableau de bord de la VM → **cartes réseau**
2. Vérifiez que l'état de la NIC est **Actif**
3. Confirmez que la **Réseau** colonne affiche le bon réseau — comparez avec une VM fonctionnelle dans le même environnement
4. Si c'est incorrect, modifiez la NIC et réattribuez-la au bon réseau
5. Redémarrez la VM

### Pilotes VirtIO manquants

**Symptôme :** La VM Windows n'affiche aucun adaptateur réseau dans le Gestionnaire de périphériques, même si une NIC est configurée dans VergeOS.

**Résolution :**

1. Vérifiez qu'une NIC existe dans la **cartes réseau** section de la VM dans VergeOS
2. Connectez-vous à la VM via la **console distante**
3. Installez les pilotes VirtIO à partir de l'ISO de l'agent invité — reportez-vous à la documentation VergeOS sur [l'agent invité de la VM](https://docs.verge.io/run-the-platform/fr/machines-virtuelles/vm-guest-agent.md) pour les étapes de téléchargement et d'installation
4. Après l'installation du pilote, Windows détectera automatiquement l'adaptateur réseau

### Configuration IP de l'invité incorrecte

**Symptôme :** La NIC est présente et les pilotes sont installés, mais la VM ne peut toujours pas accéder au réseau.

**Résolution :**

1. Dans le système d'exploitation invité, vérifiez que l'adaptateur réseau est détecté et activé
2. Pour DHCP : assurez-vous qu'un service DHCP est en cours d'exécution sur le réseau (consultez **Réseaux → \[Réseau] → DHCP**)
3. Pour une IP statique : confirmez que l'adresse IP, le masque de sous-réseau, la passerelle et les paramètres DNS correspondent à la conception du réseau
4. Utilisez l' **outil de diagnostic réseau** (ping, analyse ARP) depuis le contexte réseau VergeOS pour vérifier la connectivité de couche 2

***

## Rapport de mémoire de l'invité

Les administrateurs migrant depuis VMware ou Nutanix remarquent souvent que VergeOS signale une utilisation mémoire plus élevée qu'ils ne l'attendent. C'est normal — ce n'est pas un problème.

### Mémoire allouée vs mémoire active

**Symptôme :** VergeOS indique qu'une VM utilise 8 Go de RAM, mais le gestionnaire de tâches du système d'exploitation invité n'en montre que 2 Go en cours d'utilisation.

**Explication :** VergeOS affiche la mémoire **allouée** — la RAM physique réservée sur l'hôte pour cette VM. Lorsque vous attribuez 8 Go à une VM, l'hyperviseur réserve immédiatement 8 Go de mémoire physique, indépendamment de ce que l'invité consomme réellement. Il s'agit du véritable engagement de ressources sur l'hôte.

### Aucun surengagement mémoire

Contrairement aux plateformes qui s'appuient sur le ballooning mémoire pour récupérer la mémoire invitée inutilisée, **VergeOS n'utilise volontairement pas le ballooning**. Ce choix de conception offre :

* **Performances prévisibles** — pas de surcharge liée au pilote de ballooning ni de pression mémoire surprise
* **Planification simplifiée des capacités** — alloué = engagé ; pas d'estimation des ratios de surallocation
* **Fiabilité renforcée** — aucun risque de conditions OOM induites par le ballooning dans les invités
* **Dimensionnement précis des migrations** — ce que vous allouez est ce dont vous avez besoin sur l'hôte de destination

### Bonnes pratiques de planification des capacités

| Métrique                                        | Où vérifier                                                                 | Ce que cela signifie                         |
| ----------------------------------------------- | --------------------------------------------------------------------------- | -------------------------------------------- |
| **RAM allouée à la VM**                         | Tableau de bord de la VM                                                    | RAM physique réservée pour cette VM          |
| **RAM active de l'invité**                      | Dans le système d'exploitation invité (Gestionnaire des tâches / `free -h`) | Ce que l'invité utilise réellement           |
| **RAM disponible du nœud**                      | Tableau de bord du nœud → Mémoire                                           | Quantité de RAM hôte encore non allouée      |
| **Pourcentage maximal cible de RAM du cluster** | Système → Paramètres → Avancé                                               | Seuil pour les décisions de placement des VM |

{% hint style="success" %}
**Ajustement de la taille des VM**

Comme VergeOS alloue la totalité de la quantité, l'ajustement de la taille de la mémoire des VM est plus important que sur les plateformes avec ballooning. Commencez avec des allocations prudentes et n'augmentez que lorsque la surveillance de l'invité montre une utilisation élevée et soutenue.
{% endhint %}

***

## Bruit SEL (journaux IPMI faux positifs)

Certains matériels serveur génèrent des entrées de journal IPMI répétitives et bénignes qui remplissent le journal des événements système (SEL) et déclenchent des alertes inutiles. Le plus fréquent est le message **"Get SEL Info command failed"** .

### Comprendre le SEL

Le journal des événements système est stocké dans le matériel (sur le contrôleur BMC/IPMI) avec une capacité limitée. Une fois plein, **aucun nouvel événement ne peut être enregistré** jusqu'à ce que le journal soit effacé. Le tableau de bord du nœud affiche la capacité SEL sous forme de barre de pourcentage.

### Filtrer le bruit SEL via l'API

Pour supprimer les faux positifs sans perdre les vraies alertes matérielles :

1. Accédez à **Système → Documentation de l'API**
2. Recherchez la table **settings** et développez-la
3. Cliquez sur l'option **POST** et saisissez ce corps :

```json
{
  "key": "syslog_regex_list",
  "value": "2E2A4765742053454C20496E666F20636F6D6D616E64206661696C65642E",
  "default_value": "",
  "description": "Lignes codées en hexadécimal d'expressions régulières à filtrer du syslog"
}
```

4. Cliquez sur **Exécuter**

La valeur est une regex encodée en hexadécimal : `.*Get SEL Info command failed.` — vous pouvez encoder des modèles supplémentaires à l'aide d'un outil d'encodage hexadécimal et séparer plusieurs modèles avec `|`.

**Exemple — filtrer deux modèles :**

La regex `(Get SEL Info command failed|Unable to send command: Device or resource busy)` s'encode en :

```
284765742053454C20496E666F20636F6D6D616E64206661696C65647C556E61626C6520746F2073656E6420636F6D6D616E643A20446576696365206F72207265736F75726365206275737929
```

### Redémarrage du service IPMI

Après avoir appliqué le filtre, redémarrez la capture des journaux sur chaque nœud concerné :

**Option A — via l'interface utilisateur :**

1. Accédez à **Infrastructure → Nœuds → \[Nœud]**
2. Modifiez le nœud, **décochez** "Capture System Logs", validez
3. Attendez 15 secondes
4. Modifiez à nouveau le nœud, **réactivez** "Capture System Logs"

**Option B — via SSH :**

```bash
sudo systemctl restart openipmi
```

### Effacer un SEL plein

Si le SEL est déjà plein :

1. Accédez à **Infrastructure → Nœuds → \[Nœud]**
2. Cliquez sur **Effacer le SEL** dans le menu de gauche
3. Confirmez avec **Oui**

***

## Problèmes de partage NAS

### Windows : impossible de se connecter aux partages CIFS

**Symptôme :** Les clients Windows 10/11 ne peuvent pas accéder aux partages CIFS, recevant des erreurs « accès refusé » ou « impossible de se connecter » même avec des identifiants corrects.

**Cause racine :** Par défaut, Windows moderne désactive les connexions invité non sécurisées pour les connexions SMB.

**Résolution — activer les connexions invité non sécurisées :**

1. Appuyez sur `Win + R`, tapez `gpedit.msc`, appuyez sur Entrée
2. Accédez à : **Configuration ordinateur → Modèles d’administration → Réseau → Lanman Workstation**
3. Localisez **Activer les connexions invité non sécurisées** → clic droit → **Modifier**
4. Sélectionnez **Activé** → cliquez sur **OK**
5. **Redémarrez** le périphérique Windows

{% hint style="warning" %}
**édition Windows Famille**

`gpedit.msc` n'est pas disponible sur Windows Famille. Utilisez plutôt l'Éditeur du Registre : accédez à `HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\LanmanWorkstation\Parameters` et définissez `AllowInsecureGuestAuth` (DWORD) à `1`.
{% endhint %}

### macOS : échecs de connexion ou performances médiocres

**Symptôme :** Le Finder macOS ne peut pas se connecter aux partages CIFS, les connexions se coupent de manière intermittente ou les performances sont inutilisables.

**Résolution — forcer SMB3 via `nsmb.conf`:**

1. Ouvrez Terminal et créez ou modifiez la configuration SMB :

```bash
sudo nano /etc/nsmb.conf
```

2. Ajoutez ce qui suit :

```ini
[default]
smb_neg=smb3_only
signing_required=no
```

3. **Videz le cache SMB de macOS :**

```bash
sudo rm -rf /var/db/samba/*
sudo rm -rf /var/db/smb/*
```

4. **Redémarrez votre Mac** pour appliquer les modifications

**Options de configuration avancées pour les clients macOS :** Pour une meilleure compatibilité macOS, ajoutez les directives orientées macOS (y compris `vfs objects = fruit streams_xattr` et le `fruit:*` associé) dans **Options de configuration avancées** dans les paramètres CIFS du NAS (**NAS → CIFS**). Cela active les extensions SMB natives d'Apple.

### Erreurs d'autorisation refusée

**Symptôme :** Les utilisateurs reçoivent « Accès refusé » lorsqu'ils parcourent ou ouvrent des fichiers sur un partage, même s'ils peuvent voir le nom du partage.

**Liste de vérification de résolution :**

1. **Liste des utilisateurs valides :** Accédez à **NAS → Partages → \[Partage]** et confirmez que l'utilisateur ou le groupe figure dans la liste des utilisateurs valides
2. **Paramètre Browseable :** Assurez-vous que le partage est défini sur **consultable** si les utilisateurs doivent le découvrir
3. **Force User / Force Group :** Si configuré, vérifiez que l'utilisateur/groupe forcé dispose des autorisations de lecture/écriture sur le volume sous-jacent
4. **Redémarrage du service NAS :** Après les modifications d'autorisation, redémarrez le service NAS pour les appliquer

### Performances CIFS lentes

**Symptôme :** Les transferts de fichiers via CIFS sont beaucoup plus lents que prévu.

**Résolution :**

1. **Version du protocole SMB :** Dans **NAS → Volumes → \[Volume] → Configuration avancée**, vérifiez la version minimale du protocole SMB. La définir trop bas (SMB1) impose une négociation héritée
2. **Chemin réseau :** Utilisez les diagnostics réseau (ping, traceroute) pour vérifier la latence entre le sous-réseau client et le réseau NAS
3. **Charge de connexion :** Utilisez Diagnostics NAS → **État Samba** pour vérifier les connexions actives et identifier les partages surchargés
4. **Ressources NAS :** Vérifiez l'allocation CPU et mémoire pour le service NAS — des VM NAS sous-dimensionnées limiteront le débit

***

## Dépannage de l'installation

### Problèmes de démarrage

**Symptôme :** Le nœud ne démarre pas à partir de l'installateur USB VergeOS.

**Résolution :**

* Vérifiez que les paramètres de démarrage BIOS/UEFI correspondent au type de support d'installation (UEFI recommandé)
* Testez le support USB sur un système dont le bon fonctionnement est connu pour écarter un disque défectueux
* Confirmez la compatibilité matérielle — vérifiez que le CPU prend en charge le 64 bits avec la virtualisation matérielle (VT-x/AMD-V)
* Désactivez Secure Boot dans le BIOS si l'installateur ne parvient pas à se charger

### Discordances de configuration réseau

**Symptôme :** L'installation se termine mais le nœud ne peut pas communiquer avec les autres nœuds ou avec le réseau.

**Résolution :**

* Pendant l'installation, **arrêtez immédiatement** si une IP ou une interface détectée ne correspond pas à la conception de votre réseau
* Vérifiez que les configurations VLAN correspondent aux paramètres du port de switch
* Vérifiez les connexions des câbles physiques — l'installateur détecte automatiquement les interfaces ; un câblage non conforme entraîne une affectation incorrecte des interfaces
* Confirmez que l'adressage IP n'entre pas en conflit avec des périphériques existants sur le réseau

### Mode JBOD du contrôleur de stockage

**Symptôme :** L'installateur VergeOS ne détecte pas tous les disques attendus.

**Résolution :**

* VergeOS exige que les disques soient présentés comme des disques individuels (mode JBOD/passthrough), **pas** et non comme des matrices RAID
* Entrez dans le BIOS du contrôleur de stockage (par ex. PERC, MegaRAID) et configurez chaque disque comme un volume JBOD ou un RAID-0 individuel
* Certains contrôleurs nécessitent des mises à jour du micrologiciel pour prendre en charge le mode JBOD — consultez la documentation du fournisseur du matériel

### Échecs de jonction d'un nœud secondaire

**Symptôme :** Le contrôleur secondaire ou le nœud de calcul ne parvient pas à rejoindre le cluster existant.

**Résolution :**

1. Vérifiez que vous avez sélectionné **"Non"** lorsqu'on vous demande s'il s'agit d'une nouvelle installation (pour les nœuds secondaires)
2. Confirmez que vous avez saisi **les identifiants administrateur du contrôleur principal** correctement
3. Assurez-vous que les deux nœuds sont sur le même réseau et peuvent se joindre (vérifiez les affectations VLAN des ports de switch)
4. Faites correspondre exactement les paramètres de chiffrement du contrôleur principal
5. Faites correspondre les affectations de niveaux de disque du contrôleur principal
6. Si le nœud secondaire démarre mais n'apparaît pas dans l'interface principale, vérifiez la configuration du réseau du tissu central et la connectivité du switch entre les nœuds

***

## Problèmes de stockage

### État dégradé du vSAN

**Symptôme :** Le tableau de bord affiche un niveau vSAN en état « dégradé » ou « non redondant ».

**Explication :** Un état dégradé signifie qu'un ou plusieurs disques d'un niveau ont échoué ou sont indisponibles, mais que le vSAN reste opérationnel. Les données restent accessibles car VergeOS maintient la redondance entre les nœuds.

**Résolution :**

1. Accédez à **Système → vSAN → Disques** pour identifier le ou les disque(s) défaillant(s)
2. Vérifiez les données SMART du disque via **Diagnostics du nœud → Test de diagnostic S.M.A.R.T.**
3. Si un remplacement physique est nécessaire, utilisez **Diagnostics du nœud → Contrôle des LED** pour allumer le logement du disque afin de l'identifier
4. Contactez le support Verge pour obtenir des conseils sur le remplacement du disque — le vSAN reconstruira automatiquement la redondance une fois un disque de remplacement ajouté

### Temps de reconstruction du disque

**Comprendre les attentes :** Les temps de reconstruction dépendent de la quantité de données sur le niveau et de la capacité d'E/S des disques restants. Pendant une reconstruction :

* Le système reste pleinement opérationnel
* Les performances d'écriture peuvent être légèrement réduites
* Surveillez la progression via l'indicateur de progression du niveau dans le tableau de bord vSAN (100 % = terminé)

{% hint style="success" %}
**Réduire au minimum l'impact de la reconstruction**

Évitez de planifier des migrations de charges lourdes ou de gros imports de données pendant une reconstruction. Le vSAN priorise les opérations de reconstruction, mais les E/S supplémentaires prolongent la fenêtre de reconstruction.
{% endhint %}

### Avertissements de seuil de capacité

**Symptôme :** Les alertes du tableau de bord avertissent lorsque la capacité de stockage approche des limites.

**Résolution :**

1. Vérifiez l'utilisation du niveau dans **Système → vSAN** — chaque niveau affiche la capacité utilisée par rapport à la capacité totale
2. Consultez les données SMART du disque via **Infrastructure → Nœuds → \[Nœud] → Diagnostics → Test de diagnostic S.M.A.R.T.** pour vérifier les niveaux d'usure et les indicateurs de santé des disques
3. Pour un soulagement immédiat, identifiez et supprimez les snapshots inutiles ou les disques de VM inutilisés
4. Pour une résolution à long terme, ajoutez des disques ou des nœuds pour étendre le niveau — reportez-vous aux procédures de montée en charge du vSAN

Les points de rupture suivants sont **des indications de formation** pour la planification, et non des seuils documentés. Les valeurs documentées sont le **seuil de forte utilisation par défaut de 80 % de l'abonnement** (utilisé par les alertes de forte utilisation du vSAN/niveau de stockage préconfigurées) et le **90% `sync_max_usage`** seuil à partir duquel le vSAN limite les écritures et marque le niveau `outofspace`.

| Niveau d'utilisation | Action requise                                                                         |
| -------------------- | -------------------------------------------------------------------------------------- |
| **< 70%**            | Fonctionnement normal — aucune action requise                                          |
| **70–85%**           | Planifiez l'extension de capacité ; examinez les politiques de rétention des snapshots |
| **85–90%**           | Réduisez activement l'utilisation ou ajoutez de la capacité                            |
| **> 90%**            | Critique — privilégier l’extension ; risque d’échecs d’écriture                        |

***

## Arbre de décision de dépannage

Lorsque vous êtes confronté à un problème qui ne correspond pas aux catégories ci-dessus, suivez ce flux de travail général :

### 1. Définir le périmètre du problème

Le problème affecte-t-il une VM, un réseau, un nœud ou l’ensemble du système ? La définition du périmètre détermine par quel outil de diagnostic commencer.

### 2. Utiliser les diagnostics des composants

Commencez par l’outil de diagnostic spécifique au composant (réseau, nœud, NAS ou diagnostics vSAN) — il s’exécute automatiquement dans le bon contexte.

### 3. Vérifier les journaux système

Consultez les journaux du tableau de bord et les alertes système pour des événements corrélés. Recherchez des schémas — plusieurs alertes se sont-elles déclenchées en même temps ?

### 4. Escalader avec des données

Si le problème n’est pas résolu, générez un **Diagnostics système** lot (Système → Diagnostics système) et soumettez-le avec votre demande d’assistance.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verge.io/learn-the-platform/fr/module-9-supervision-et-depannage/06-common-issues.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
