Skip to main content

Diagnostiquer une descente d'image lente ou en échec avec DavOS

S'applique à : Medulla
Version : Toutes versions (selon disponibilité des outils)
Environnement : On-Premise
Catégorie : Imagerie / DavOS / Clonezilla / NFS
Mise à jour : 19 novembre 2026

1. Présentation

Cette procédure permet de diagnostiquer une descente d'image (restauration) lente ou en échec réalisée avec DavOS et Clonezilla dans Medulla.

Deux outils permettent d'identifier les éventuels problèmes de performances :

Outil Où l'exécuter Ce qu'il vérifie
davos-diag Sur le poste sous DavOS, pendant la restauration Matériel, réseau, NFS (identité, sessions, retransmissions et latence), restauration en cours, disque, débits, messages noyau et logs DavOS / Clonezilla / partclone.
davos-diag-serveur.sh Sur le serveur Medulla Serveur NFS, versions et threads, saturation, identités des postes connectés, débit réseau, lecture disque et synthèse des rapports des postes.

Chaque contrôle affiche un verdict :

  • [OK] : contrôle satisfaisant.
  • [ATTENTION] : anomalie possible ou point nécessitant une vérification.
  • [PROBLEME] : anomalie détectée ou seuil critique atteint.

Le rapport du poste indique également un goulot d'étranglement probable : lien réseau, décompression, partclone, écriture disque ou réseau / NFS / serveur.

Information : en dehors de leurs rapports, les deux outils réalisent des opérations de lecture. Ils ne modifient ni les postes, ni les paramètres du serveur, ni les images. Ils s'exécutent avec une priorité processeur et disque basse afin de limiter leur impact sur la restauration.

2. Prérequis

  • Accès root au serveur Medulla.
  • Pour le diagnostic manuel, accès SSH root aux postes démarrés sous DavOS.
  • Une restauration en cours pour obtenir des mesures de débit représentatives.
  • Plusieurs postes en restauration simultanée pour rechercher d'éventuels problèmes de concurrence NFS.

Il est recommandé de lancer les mesures pendant la restauration de la partition principale, lorsque la barre de progression partclone est visible.

3. Disponibilité des outils de diagnostic

Les outils de diagnostic sont fournis avec le paquet medulla-davos-client. Sur les versions qui les intègrent, aucun téléchargement supplémentaire n'est nécessaire.

Outil Emplacement Commande
Diagnostic poste /usr/sbin/davos-diag, intégré à l'image DavOS davos-diag
Diagnostic serveur /usr/sbin/davos-diag-serveur.sh davos-diag-serveur.sh

3.1. Vérifier la présence des outils

Sur le serveur Medulla :

ls -l /usr/sbin/davos-diag-serveur.sh

unsquashfs -l /var/lib/pulse2/imaging/davos/fs.squashfs | grep davos-diag

La première commande vérifie la présence du diagnostic serveur. La seconde vérifie que le diagnostic poste est intégré à l'image DavOS.

3.2. Versions antérieures de DavOS

Si les outils ne sont pas présents, il est recommandé de mettre à jour le paquet medulla-davos-client.

À défaut, les scripts peuvent être téléchargés et installés manuellement :

wget https://dl.medulla-tech.io/ma/davos-diag.sh
wget https://dl.medulla-tech.io/ma/davos-diag-serveur.sh

cp davos-diag.sh /var/lib/pulse2/imaging/logs/

cp davos-diag-serveur.sh /usr/sbin/
chmod +x /usr/sbin/davos-diag-serveur.sh

Le script poste devient alors accessible depuis DavOS dans :

/mnt/logs/davos-diag.sh

Dans ce cas, remplacer la commande davos-diag par :

bash /mnt/logs/davos-diag.sh

4. Diagnostic manuel

Étape 1 – Lancer la restauration

Depuis Medulla, lancer la restauration d'une image sur un ou plusieurs postes.

Attendre que Clonezilla commence la copie de la partition principale, avec la progression partclone visible.

Étape 2 – Lancer le diagnostic sur un poste

Se connecter en SSH au poste sous DavOS, avec les droits root.

Pour effectuer une mesure de 60 secondes, avec un échantillon toutes les 5 secondes :

davos-diag

Pour prolonger la mesure à 120 secondes :

davos-diag -d 120

Pour modifier la durée et l'intervalle :

davos-diag -d 120 -i 10

Lorsque plusieurs postes restaurent simultanément, lancer le diagnostic sur deux ou trois d'entre eux afin de comparer leurs résultats.

4.1. Options disponibles

Option Description
-d SECONDES Durée de la mesure, 60 secondes par défaut.
-i SECONDES Intervalle entre les mesures, 5 secondes par défaut.
-w Attendre le démarrage de partclone, pendant 15 minutes au maximum, avant de mesurer.
-L Collecter uniquement les logs, sans effectuer de mesures. Utilisé notamment en fin de restauration.

Étape 3 – Lancer le diagnostic serveur

Pendant que les postes restaurent, lancer sur le serveur Medulla :

davos-diag-serveur.sh -n 6

Dans cet exemple, six postes sont en cours de restauration.

Le paramètre -n permet d'indiquer le nombre de postes attendus et de le comparer avec les clients NFS observés.

Étape 4 – Récupérer les résultats

Les rapports sont enregistrés sur le serveur dans :

/var/lib/pulse2/imaging/logs/davos-diag/

Un sous-dossier est créé pour chaque poste et chaque exécution, ainsi qu'un dossier pour le diagnostic serveur.

Les principaux fichiers sont :

Fichier Contenu
rapport.txt Synthèse, contrôles et verdicts.
echantillons.csv Mesures de performances collectées périodiquement.
brut/ Sorties détaillées des commandes et copies des journaux.

5. Diagnostic automatique

DavOS peut lancer automatiquement davos-diag pendant chaque restauration, sans nécessiter de connexion SSH aux postes.

Cette fonctionnalité est désactivée par défaut et s'active depuis le serveur Medulla.

5.1. Activer le diagnostic automatique

Sur le serveur Medulla :

touch /var/lib/pulse2/imaging/logs/davos-diag.enable

Cette commande active une mesure de 60 secondes.

Pour demander une mesure de 120 secondes :

echo '-d 120' > /var/lib/pulse2/imaging/logs/davos-diag.enable

Seules les options -d et -i, suivies d'une valeur numérique, sont interprétées dans ce fichier.

5.2. Activer le diagnostic sur un poste précis

Il est également possible d'activer le diagnostic avec le paramètre noyau :

davos_diag=1

Ce paramètre permet d'activer le diagnostic pour le poste concerné.

5.3. Fonctionnement du diagnostic automatique

Lorsque le diagnostic automatique est activé :

  1. DavOS démarre normalement.
  2. La restauration Clonezilla est lancée.
  3. Le diagnostic attend le démarrage de partclone.
  4. Les performances sont mesurées pendant la durée configurée.
  5. Les résultats sont enregistrés sur le serveur.
  6. Les journaux sont collectés en fin de restauration.

Deux dossiers sont généralement créés pour chaque poste :

<poste>-<date>
<poste>-<date>-fin

Le premier contient les mesures réalisées pendant la restauration. Le second contient les journaux collectés en fin d'opération.

Information : le diagnostic fonctionne en arrière-plan, avec une priorité basse. Les étapes sont limitées dans le temps et les erreurs du diagnostic ne bloquent pas la restauration. En fin de restauration, DavOS attend au maximum 20 secondes la collecte des journaux.

5.4. Désactiver le diagnostic automatique

rm /var/lib/pulse2/imaging/logs/davos-diag.enable

Sans le fichier d'activation ni le paramètre noyau davos_diag=1, DavOS fonctionne normalement, sans lancer le diagnostic automatique.

5.5. Versions antérieures de DavOS

Si l'image DavOS ne contient pas encore le mécanisme de diagnostic automatique, mettre à jour le paquet medulla-davos-client.

À défaut, télécharger l'installateur d'intégration :

wget https://dl.medulla-tech.io/ma/medulla-davos-diag-install.sh

bash medulla-davos-diag-install.sh

Le script sauvegarde l'image DavOS existante, ajoute le diagnostic puis reconstruit l'image.

La sauvegarde est nommée selon le format :

fs.squashfs.avant-diag-<date>

Pour revenir à l'image précédente :

bash medulla-davos-diag-install.sh --rollback

Important : l'intégration manuelle modifie l'image DavOS. Il est recommandé de réaliser cette opération pendant une fenêtre de maintenance et de valider le démarrage sur un poste pilote.

6. Lire et interpréter les rapports

Commencer par la section Synthèse, à la fin du rapport, qui regroupe les contrôles [ATTENTION] et [PROBLEME].

Consulter ensuite la ligne Goulot dans le bloc « Analyse des mesures ».

6.1. Contrôles réalisés sur le poste

Bloc Contrôle Anomalies recherchées
Matériel Mémoire, processeur, BIOS. Mémoire disponible inférieure à 512 Mo.
Réseau Vitesse, duplex, erreurs, latence. Lien inférieur à 1000 Mbit/s, half duplex, erreurs réseau, ping supérieur à 5 ms.
NFS Version, identité NFSv4, rsize. Identité NFSv4 non définie, rsize inférieur à 256 Ko.
Restauration Processus ocs-sr et partclone. Aucune restauration en cours.
Disque SMART, température, erreurs noyau. Avertissement critique NVMe, température d'au moins 70 °C, erreurs disque.
Analyse Sessions, retransmissions, latence NFS. Renégociations, expirations, reconnexions TCP, latence supérieure à 50 ms.
Messages noyau Carte réseau, firmware, stockage, NFS. Blocages, pertes de connexion, bridage thermique.
Logs DavOS, Clonezilla, partclone. Échecs de montage, disque trop petit, erreurs de somme de contrôle.

6.2. Identification du goulot d'étranglement

Le script détermine le goulot à partir des moyennes des mesures, dans l'ordre suivant :

Verdict Condition Interprétation
Lien utilisé à X % Débit reçu supérieur ou égal à 80 % du lien. Le poste utilise fortement sa capacité réseau.
Goulot : décompression pigz ou zstd utilise au moins 90 % d'un cœur. La décompression peut limiter le débit.
Goulot : partclone partclone utilise au moins 90 % d'un cœur. Le traitement partclone peut limiter la restauration.
Goulot : écriture disque iowait supérieur ou égal à 20 %. Le stockage cible est une piste prioritaire.
Goulot : réseau / NFS / serveur Aucun des cas précédents. Examiner les communications NFS et le serveur.

Interprétation : les verdicts permettent d'orienter le diagnostic. Ils ne constituent pas toujours une preuve définitive de la cause du ralentissement. Il est recommandé de comparer les mesures du poste et du serveur.

6.3. Contrôles réalisés sur le serveur

Le rapport serveur signale notamment :

  • Les identités NFSv4 génériques ou dupliquées.
  • Un nombre de machines connectées inférieur au nombre annoncé.
  • Moins de 16 threads nfsd.
  • Plus de 10 % de requêtes NFS en attente d'un thread.
  • Une attente disque serveur supérieure ou égale à 20 %.
  • Un débit moyen par poste inférieur à 300 Mbit/s.

7. Questions fréquentes

7.1. Un poste seul est rapide, mais plusieurs postes sont très lents. Pourquoi ?

Une cause possible est un problème d'identité ou de session NFSv4.

Dans certaines versions de DavOS, les partages NFS peuvent être montés avant l'attribution du nom définitif du poste.

Plusieurs machines peuvent alors présenter une identité générique :

debian
localhost.localdomain

Le diagnostic peut signaler :

  • « Identité NFSv4 non définie ».
  • « Sessions NFSv4 renégociées ».
  • « Nom générique » côté serveur.

Le correctif d'identité NFSv4 attribue à chaque poste une identité construite à partir de son adresse MAC :

davos-<adresse MAC>

Important : un nom d'hôte identique et une identité NFSv4 identique sont deux notions différentes. Une identité générique ou dupliquée doit être examinée, mais ne démontre pas à elle seule une collision de sessions ou une perte de débit. Vérifier également les renégociations, les retransmissions et les performances mesurées.

7.2. Le rapport indique « Lien négocié à 100 Mbit/s »

Le poste ne négocie pas une connexion Gigabit.

Vérifier le câble, la prise, le brassage, le port du switch et le pilote réseau.

ethtool <interface> | grep -E 'Speed|Duplex'

Un lien à 100 Mbit/s limite le débit théorique à environ 12,5 Mo/s, avant les surcharges protocolaires.

7.3. Le rapport indique « Goulot : décompression »

Le processeur consacre une part importante de ses ressources à la décompression de l'image.

Les images gzip utilisant -z1p peuvent être limitées par les performances de décompression du poste.

Une piste d'optimisation consiste à utiliser zstd, avec l'option Clonezilla -z9p, selon les paramètres de l'entité.

Une image existante peut être convertie avec :

ocs-cvtimg-comp

Il est recommandé de comparer les performances sur un poste pilote avant de généraliser le changement.

7.4. Le rapport indique « Goulot : réseau / NFS / serveur »

Le poste semble attendre les données nécessaires à la restauration.

Vérifier dans l'ordre :

  1. L'identité et les sessions NFSv4.
  2. Les retransmissions et expirations NFS.
  3. La latence NFS.
  4. Les threads nfsd.
  5. L'attente disque serveur.
  6. Le débit réseau émis par le serveur.

7.5. Le rapport indique des retransmissions NFS ou des reconnexions TCP

Ces événements peuvent résulter de pertes réseau, d'un équipement saturé, d'un pare-feu interrompant les connexions ou d'un serveur ne répondant plus suffisamment rapidement.

Vérifier les compteurs réseau :

ethtool -S <interface> | grep -iE 'err|drop|miss'

Rechercher les pertes de communication NFS :

dmesg | grep -i 'not responding'

Comparer les compteurs avant et pendant la restauration pour distinguer les erreurs anciennes des erreurs nouvelles.

7.6. Le rapport indique « Goulot : écriture disque »

Le disque cible peut limiter la restauration.

Les causes possibles comprennent :

  • Un disque mécanique.
  • Un SSD saturé.
  • Un SSD présentant une limitation thermique.
  • Un disque défaillant.

Consulter :

brut/nvme-smart.txt
brut/dmesg.txt

7.7. Faut-il utiliser NFSv3 ou NFSv4 ?

Il est recommandé de conserver NFSv4 lorsque les clients disposent d'une identité correctement initialisée.

NFSv4 utilise principalement le port TCP 2049 et simplifie la configuration réseau.

NFSv3 n'utilise pas le mécanisme d'identité client NFSv4, mais nécessite des services RPC complémentaires, notamment rpcbind et mountd, selon la configuration.

En NFSv4.2, certaines opérations, notamment READ_PLUS, peuvent présenter des différences de performances selon le serveur. Pour les isoler, comparer les résultats avec un montage vers=4.1.

7.8. Le débit partclone ne correspond pas au débit réseau. Est-ce normal ?

Oui. Partclone affiche le débit des données décompressées écrites sur le disque, alors que le réseau transporte les données compressées.

Par exemple, avec une image compressée environ deux fois :

Mesure Valeur approximative
Débit partclone 12 Go/min
Débit des données restaurées 200 Mo/s
Débit réseau correspondant 800 Mbit/s

7.9. Le rapport indique « Aucune restauration en cours »

Le diagnostic a été lancé avant ou après la copie des données.

Les contrôles matériels, NFS et journaux restent utiles, mais les mesures de débit ne sont pas représentatives.

Relancer davos-diag pendant la restauration de la partition principale.

7.10. Le serveur affiche moins de machines connectées que de postes lancés

Plusieurs explications sont possibles :

  • Certains postes n'ont pas encore monté le partage NFS.
  • Certains postes ont terminé leur restauration.
  • Des clients présentent des identités NFSv4 anormales.
  • Des connexions ne sont pas visibles au moment du diagnostic.

Examiner les identités NFSv4, les sessions et les rapports des postes concernés.

8. Emplacement des journaux

Sur le poste, les journaux sont conservés en mémoire et disparaissent au redémarrage. Le diagnostic les copie dans le dossier brut/logs/.

Journal Sur le poste Sur le serveur Contenu
DavOS /var/log/davos.log davos-diag/<poste>-<date>/brut/logs/ Démarrage, montages NFS, identité NFS et action demandée.
Restauration /var/log/davos_restorer.log debug_imaging/<poste>/davos_restorer-<date>.log en cas d'erreur Commande ocs-sr, sortie Clonezilla et erreurs.
Capture /var/log/davos_saver.log debug_imaging/<poste>/ Commande de capture, compression et débit.
Clonezilla /var/log/clonezilla.log brut/logs/ Déroulement de la restauration partition par partition.
Partclone /var/log/clonezilla/partclone.log brut/logs/ Débit moyen et erreurs de lecture ou de somme de contrôle.
Messages noyau dmesg brut/dmesg.txt Réseau, pilotes, erreurs NVMe et NFS.
Image — masters/<UUID>/Info-saved-by-cmd.txt et clonezilla-img Commande de capture et paramètres de compression.

Chemins : les chemins serveur sont relatifs à /var/lib/pulse2/imaging/logs/, sauf masters/, relatif à /var/lib/pulse2/imaging/.

8.1. Rechercher rapidement les erreurs de restauration

grep -inE 'error|fail|traceback|abort|no space|cannot' /var/log/davos_restorer.log | tail

8.2. Consulter les débits partclone

grep -oE 'Ave\. Rate: *[0-9.]+ *[GM]B/min' /var/log/clonezilla/partclone.log | tail -3

8.3. Examiner les messages noyau

dmesg | grep -iE 'link is up|nvme|nfs|firmware|hang' | tail -20

9. Le poste ne démarre pas jusqu'à DavOS

Si le poste ne parvient pas à démarrer DavOS, aucun rapport de diagnostic poste ne peut être généré.

Dans ce cas, vérifier :

  • Les messages affichés à l'écran.
  • Le fonctionnement du démarrage PXE.
  • Les journaux des services PXE et HTTP.
  • Le téléchargement du noyau vmlinuz.
  • Le téléchargement de initrd.img.
  • Le chargement de fs.squashfs.

10. Informations à transmettre au support Medulla

Pour permettre une analyse complète, transmettre :

  • Le dossier de diagnostic complet.
  • Le nombre de postes restaurés simultanément.
  • La durée de la restauration.
  • Le nom de l'image restaurée.

Pour créer une archive :

tar czf davos-diag-$(hostname)-$(date +%Y%m%d).tar.gz -C /var/lib/pulse2/imaging/logs davos-diag

Le dossier contenant les rapports est :

/var/lib/pulse2/imaging/logs/davos-diag/

Confidentialité : les rapports peuvent contenir des noms de machines, adresses IP, informations matérielles et chemins internes. Vérifier leur contenu avant transmission.

11. Résumé

Le diagnostic DavOS permet d'identifier les principales causes d'une restauration lente ou en échec :

  • Débit réseau insuffisant.
  • Identité ou sessions NFSv4 anormales.
  • Retransmissions et latence NFS.
  • Saturation du serveur NFS.
  • Limitation liée à la décompression.
  • Limitation de partclone.
  • Performances insuffisantes du disque cible.
  • Erreurs matérielles ou de restauration.

Les outils davos-diag et davos-diag-serveur.sh sont fournis avec le paquet medulla-davos-client sur les versions qui intègrent cette fonctionnalité.

Le diagnostic peut être lancé manuellement ou automatiquement pendant les restaurations.

À retenir : pour diagnostiquer efficacement une descente d'image lente, comparer les rapports de plusieurs postes avec celui du serveur Medulla. Cette approche permet de distinguer les limitations propres à un poste des problèmes de réseau, de sessions NFS ou de stockage partagé.