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
rootau serveur Medulla. - Pour le diagnostic manuel, accès SSH
rootaux 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é :
- DavOS démarre normalement.
- La restauration Clonezilla est lancée.
- Le diagnostic attend le démarrage de partclone.
- Les performances sont mesurées pendant la durée configurée.
- Les résultats sont enregistrés sur le serveur.
- 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 :
- L'identité et les sessions NFSv4.
- Les retransmissions et expirations NFS.
- La latence NFS.
- Les threads
nfsd. - L'attente disque serveur.
- 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é.