Diagnosticar una descarga de imagen lenta o fallida con DavOS
Aplicable a: Medulla
Versión: Todas las versiones (según la disponibilidad de las herramientas)
Entorno: On-Premise
Categoría: Imaging / DavOS / Clonezilla / NFS
Actualización: 19 de noviembre de 2026
1. Presentación
Este procedimiento permite diagnosticar una descarga de imagen (restauración) lenta o fallida realizada con DavOS y Clonezilla en Medulla.
Existen dos herramientas que permiten identificar posibles problemas de rendimiento:
| Herramienta | Dónde ejecutarla | Qué comprueba |
|---|---|---|
davos-diag |
En el puesto de trabajo con DavOS, durante la restauración | Hardware, red, NFS (identidad, sesiones, retransmisiones y latencia), restauración en curso, disco, velocidades de transferencia, mensajes del núcleo y registros de DavOS / Clonezilla / partclone. |
davos-diag-serveur.sh |
En el servidor Medulla | Servidor NFS, versiones y subprocesos, saturación, identidades de los puestos de trabajo conectados, velocidad de red, lectura del disco y resumen de los informes de los puestos de trabajo. |
Cada comprobación muestra un veredicto:
- [OK]: comprobación satisfactoria.
- [ATTENTION] (atención): posible anomalía o aspecto que requiere verificación.
- [PROBLEME] (problema): se ha detectado una anomalía o se ha alcanzado un umbral crítico.
El informe del puesto de trabajo también indica un posible cuello de botella: enlace de red, descompresión, partclone, escritura en disco o red / NFS / servidor.
Nota: aparte de sus informes, ambas herramientas realizan operaciones de lectura. No modifican ni los puestos de trabajo, ni los parámetros del servidor, ni las imágenes. Se ejecutan con una prioridad baja de procesador y disco para limitar su impacto en la restauración.
2. Requisitos previos
- Acceso de
rootal servidor Medulla. - Para el diagnóstico manual, acceso SSH con privilegios de
roota los puestos de trabajo que se inician con DavOS. - Una restauración en curso para obtener mediciones de velocidad de transferencia representativas.
- Varios puestos de trabajo en proceso de restauración simultánea para detectar posibles problemas de concurrencia en NFS.
Se recomienda iniciar las mediciones durante la restauración de la partición principal, cuando sea visible la barra de progreso de partclone.
3. Disponibilidad de las herramientas de diagnóstico
Las herramientas de diagnóstico se incluyen en el paquete medulla-davos-client. En las versiones que las incorporan, no es necesaria ninguna descarga adicional.
| Herramienta | Ubicación | Comando |
|---|---|---|
| Diagnóstico del puesto de trabajo | /usr/sbin/davos-diag, integrado en la imagen de DavOS |
davos-diag |
| Diagnóstico del servidor | /usr/sbin/davos-diag-serveur.sh |
davos-diag-serveur.sh |
3.1. Comprobar la presencia de las herramientas
En el servidor Medulla:
ls -l /usr/sbin/davos-diag-serveur.sh
unsquashfs -l /var/lib/pulse2/imaging/davos/fs.squashfs | grep davos-diag
El primer comando comprueba si está presente el diagnóstico del servidor. El segundo comprueba si el diagnóstico del puesto de trabajo está integrado en la imagen de DavOS.
3.2. Versiones anteriores de DavOS
Si las herramientas no están presentes, se recomienda actualizar el paquete medulla-davos-client.
En su defecto, los scripts pueden descargarse e instalarse manualmente:
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
El script de puesto de trabajo será entonces accesible desde DavOS en:
/mnt/logs/davos-diag.sh
En este caso, sustituya el comando davos-diag por:
bash /mnt/logs/davos-diag.sh
4. Diagnóstico manual
Paso 1: Iniciar la restauración
Desde Medulla, inicie la restauración de una imagen en uno o varios puestos de trabajo.
Espere a que Clonezilla comience a copiar la partición principal, con el progreso de partclone visible.
Paso 2: Iniciar el diagnóstico en un puesto de trabajo
Conéctese por SSH al puesto de trabajo con DavOS, con privilegios de root.
Para realizar una medición de 60 segundos, con una toma de muestras cada 5 segundos:
davos-diag
Para ampliar la medición a 120 segundos:
davos-diag -d 120
Para modificar la duración y el intervalo:
davos-diag -d 120 -i 10
Cuando varios puestos de trabajo se estén restaurando simultáneamente, inicie el diagnóstico en dos o tres de ellos para comparar sus resultados.
4.1. Opciones disponibles
| Opción | Descripción |
|---|---|
-d SECONDES |
Duración de la medición, 60 segundos por defecto. |
-i SECONDES |
Intervalo entre mediciones: 5 segundos por defecto. |
-w |
Esperar a que se inicie partclone, durante un máximo de 15 minutos, antes de realizar la medición. |
-L |
Recopilar únicamente los registros, sin realizar mediciones. Se utiliza, en particular, al finalizar la restauración. |
Paso 3: Iniciar el diagnóstico del servidor
Mientras se restauran los puestos de trabajo, ejecute en el servidor Medulla:
davos-diag-serveur.sh -n 6
En este ejemplo, se están restaurando seis puestos de trabajo.
El parámetro -n permite indicar el número de puestos de trabajo esperados y compararlo con los clientes NFS detectados.
Paso 4: Recuperar los resultados
Los informes se guardan en el servidor en:
/var/lib/pulse2/imaging/logs/davos-diag/
Se crea una subcarpeta para cada puesto de trabajo y cada ejecución, así como una carpeta para el diagnóstico del servidor.
Los archivos principales son:
| Archivo | Contenido |
|---|---|
rapport.txt |
Resumen, comprobaciones y veredictos. |
echantillons.csv |
Medidas de rendimiento recopiladas periódicamente. |
brut/ |
Salidas detalladas de los comandos y copias de los registros. |
5. Diagnóstico automático
DavOS puede ejecutar automáticamente davos-diag durante cada restauración, sin necesidad de una conexión SSH a los puestos de trabajo.
Esta función está desactivada de forma predeterminada y se activa desde el servidor Medulla.
5.1. Activar el diagnóstico automático
En el servidor Medulla:
touch /var/lib/pulse2/imaging/logs/davos-diag.enable
Este comando activa una medición de 60 segundos.
Para solicitar una medición de 120 segundos:
echo '-d 120' > /var/lib/pulse2/imaging/logs/davos-diag.enable
En este archivo solo se interpretan las opciones -d y -i, seguidas de un valor numérico.
5.2. Activar el diagnóstico en un puesto de trabajo concreto
También es posible activar el diagnóstico mediante el parámetro del núcleo:
davos_diag=1
Este parámetro permite activar el diagnóstico para el puesto de trabajo en cuestión.
5.3. Funcionamiento del diagnóstico automático
Cuando el diagnóstico automático está activado:
- DavOS se inicia con normalidad.
- Se inicia la restauración con Clonezilla.
- El diagnóstico espera a que se inicie partclone.
- Se mide el rendimiento durante el tiempo configurado.
- Los resultados se registran en el servidor.
- Los registros se recopilan al finalizar la restauración.
Por lo general, se crean dos carpetas para cada puesto de trabajo:
<puesto>-<fecha>
<puesto>-<fecha>-fin
La primera contiene las mediciones realizadas durante la restauración. La segunda contiene los registros recopilados al finalizar la operación.
Nota: el diagnóstico se ejecuta en segundo plano, con prioridad baja. Las etapas tienen una duración limitada y los errores del diagnóstico no bloquean la restauración. Al finalizar la restauración, DavOS espera un máximo de 20 segundos a que se recopilen los registros.
5.4. Desactivar el diagnóstico automático
rm /var/lib/pulse2/imaging/logs/davos-diag.enable
Sin el archivo de activación ni el parámetro del núcleo davos_diag=1, DavOS funciona con normalidad, sin iniciar el diagnóstico automático.
5.5. Versiones anteriores de DavOS
Si la imagen de DavOS aún no incluye el mecanismo de diagnóstico automático, actualice el paquete medulla-davos-client.
De lo contrario, descargue el instalador de integración:
wget https://dl.medulla-tech.io/ma/medulla-davos-diag-install.sh
bash medulla-davos-diag-install.sh
El script realiza una copia de seguridad de la imagen existente de DavOS, añade el diagnóstico y, a continuación, vuelve a crear la imagen.
La copia de seguridad se nombra según el siguiente formato:
fs.squashfs.avant-diag-<fecha>
Para volver a la imagen anterior:
bash medulla-davos-diag-install.sh --rollback
Importante: la integración manual modifica la imagen de DavOS. Se recomienda realizar esta operación durante una ventana de mantenimiento y comprobar el arranque en un puesto de trabajo piloto.
6. Leer e interpretar los informes
Comience por la sección Synthèse (resumen), al final del informe, que agrupa las comprobaciones [ATTENTION] y [PROBLEME].
A continuación, consulte la línea Goulot (cuello de botella) en el bloque «Analyse des mesures» (análisis de las mediciones).
6.1. Comprobaciones realizadas en el puesto de trabajo
| Bloque | Comprobación | Anomalías buscadas |
|---|---|---|
| Hardware | Memoria, procesador, BIOS. | Memoria disponible inferior a 512 MB. |
| Red | Velocidad, dúplex, errores, latencia. | Conexión inferior a 1000 Mbit/s, semidúplex, errores de red, ping superior a 5 ms. |
| NFS | Versión, identidad NFSv4, rsize. | Identidad NFSv4 no definida, rsize inferior a 256 KB. |
| Restauración | Procesos ocs-sr y partclone. | No hay ninguna restauración en curso. |
| Disco | SMART, temperatura, errores del núcleo. | Aviso crítico de NVMe, temperatura de al menos 70 °C, errores de disco. |
| Análisis | Sesiones, retransmisiones, latencia NFS. | Renegociaciones, expiraciones, reconexiones TCP, latencia superior a 50 ms. |
| Mensajes del núcleo | Tarjeta de red, firmware, almacenamiento, NFS. | Bloqueos, pérdidas de conexión, limitación térmica. |
| Registros | DavOS, Clonezilla, partclone. | Errores de montaje, disco demasiado pequeño, errores de suma de comprobación. |
6.2. Identificación del cuello de botella
El script determina el cuello de botella a partir de los valores medios de las mediciones, en el siguiente orden:
| Veredicto | Condición | Interpretación |
|---|---|---|
| Lien utilisé à X % (enlace utilizado al X %) | La velocidad de transferencia recibida es igual o superior al 80 % del enlace. | El puesto de trabajo está utilizando en gran medida su capacidad de red. |
| Goulot : décompression (cuello de botella: descompresión) | pigz o zstd utiliza al menos el 90 % de un núcleo. | La descompresión puede limitar la velocidad de transferencia. |
| Goulot : partclone (cuello de botella: partclone) | partclone utiliza al menos el 90 % de un núcleo. | El procesamiento de partclone puede limitar la restauración. |
| Goulot : écriture disque (cuello de botella: escritura en disco) | iowait igual o superior al 20 %. | El almacenamiento de destino es una pista prioritaria. |
| Goulot : réseau / NFS / serveur (cuello de botella: red / NFS / servidor) | Ninguno de los casos anteriores. | Revisar las comunicaciones NFS y el servidor. |
Interpretación: los veredictos permiten orientar el diagnóstico. No siempre constituyen una prueba definitiva de la causa de la ralentización. Se recomienda comparar las mediciones del puesto de trabajo y del servidor.
6.3. Comprobaciones realizadas en el servidor
El informe del servidor señala, entre otras cosas:
- Identidades NFSv4 genéricas o duplicadas.
- Un número de máquinas conectadas inferior al anunciado.
- Menos de 16 subprocesos de
nfsd. - Más del 10 % de las solicitudes NFS en espera de un subproceso.
- Una espera de disco del servidor igual o superior al 20 %.
- Una velocidad de transferencia media por puesto de trabajo inferior a 300 Mbit/s.
7. Preguntas frecuentes
7.1. Un puesto de trabajo por sí solo funciona rápido, pero varios puestos son muy lentos. ¿A qué se debe?
Una posible causa es un problema de identidad o de sesión de NFSv4.
En algunas versiones de DavOS, los recursos compartidos NFS pueden montarse antes de que se asigne el nombre definitivo al puesto de trabajo.
En ese caso, varias máquinas pueden presentar una identidad genérica:
debian
localhost.localdomain
El diagnóstico puede indicar:
- «Identité NFSv4 non définie» (identidad NFSv4 no definida).
- «Sessions NFSv4 renégociées» (sesiones NFSv4 renegociadas).
- «Nom générique» (nombre genérico) en el lado del servidor.
El parche de identidad NFSv4 asigna a cada puesto de trabajo una identidad generada a partir de su dirección MAC:
davos-<dirección MAC>
Importante: un nombre de host idéntico y una identidad NFSv4 idéntica son dos conceptos distintos. Una identidad genérica o duplicada debe analizarse, pero por sí sola no demuestra una colisión de sesiones ni una pérdida de velocidad de transferencia. Compruebe también las renegociaciones, las retransmisiones y los rendimientos medidos.
7.2. El informe indica «Lien négocié à 100 Mbit/s» (enlace negociado a 100 Mbit/s)
El puesto de trabajo no negocia una conexión Gigabit.
Compruebe el cable, la toma, el cableado, el puerto del conmutador y el controlador de red.
ethtool <interface> | grep -E 'Speed|Duplex'
Un enlace a 100 Mbit/s limita la velocidad de transferencia teórica a unos 12,5 MB/s, antes de las sobrecargas de protocolo.
7.3. El informe indica «Goulot : décompression» (cuello de botella: descompresión)
El procesador dedica una parte importante de sus recursos a la descompresión de la imagen.
Las imágenes gzip que utilizan -z1p pueden verse limitadas por el rendimiento de descompresión del puesto de trabajo.
Una posibilidad de optimización consiste en utilizar zstd, con la opción de Clonezilla -z9p, según la configuración de la entidad.
Una imagen existente puede convertirse con:
ocs-cvtimg-comp
Se recomienda comparar el rendimiento en un puesto de trabajo piloto antes de aplicar el cambio de forma generalizada.
7.4. El informe indica «Goulot : réseau / NFS / serveur» (cuello de botella: red / NFS / servidor)
El puesto de trabajo parece estar a la espera de los datos necesarios para la restauración.
Compruebe, en este orden:
- La identidad y las sesiones NFSv4.
- Las retransmisiones y las expiraciones de NFS.
- La latencia de NFS.
- Los subprocesos de
nfsd. - La espera del disco del servidor.
- La velocidad de red emitida por el servidor.
7.5. El informe indica retransmisiones NFS o reconexiones TCP
Estos eventos pueden deberse a pérdidas de red, a un equipo saturado, a un cortafuegos que interrumpe las conexiones o a un servidor que ya no responde con la suficiente rapidez.
Compruebe los contadores de red:
ethtool -S <interface> | grep -iE 'err|drop|miss'
Busque pérdidas de comunicación NFS:
dmesg | grep -i 'not responding'
Compare los contadores antes y durante la restauración para distinguir los errores antiguos de los nuevos.
7.6. El informe indica «Goulot : écriture disque» (cuello de botella: escritura en disco)
El disco de destino puede limitar la restauración.
Entre las posibles causas se incluyen:
- Un disco mecánico.
- Un SSD saturado.
- Un SSD con limitación térmica.
- Un disco defectuoso.
Consulte:
brut/nvme-smart.txt
brut/dmesg.txt
7.7. ¿Es preferible utilizar NFSv3 o NFSv4?
Se recomienda mantener NFSv4 cuando los clientes dispongan de una identidad correctamente inicializada.
NFSv4 utiliza principalmente el puerto TCP 2049 y simplifica la configuración de red.
NFSv3 no utiliza el mecanismo de identidad de cliente de NFSv4, pero requiere servicios RPC adicionales, en particular rpcbind y mountd, según la configuración.
En NFSv4.2, algunas operaciones, en particular READ_PLUS, pueden presentar diferencias de rendimiento según el servidor. Para aislarlas, compare los resultados con un montaje con la opción vers=4.1.
7.8. La velocidad de partclone no se corresponde con la velocidad de la red. ¿Es esto normal?
Sí. Partclone muestra la velocidad de transferencia de los datos descomprimidos que se escriben en el disco, mientras que la red transporta los datos comprimidos.
Por ejemplo, con una imagen comprimida aproximadamente al doble:
| Medida | Valor aproximado |
|---|---|
| Velocidad de partclone | 12 GB/min |
| Velocidad de transferencia de los datos restaurados | 200 MB/s |
| Velocidad de red correspondiente | 800 Mbit/s |
7.9. El informe indica «Aucune restauration en cours» (no hay ninguna restauración en curso)
El diagnóstico se ha iniciado antes o después de la copia de los datos.
Las comprobaciones de hardware, NFS y registros siguen siendo útiles, pero las mediciones de velocidad no son representativas.
Vuelva a ejecutar davos-diag durante la restauración de la partición principal.
7.10. El servidor muestra menos máquinas conectadas que puestos de trabajo iniciados
Hay varias explicaciones posibles:
- Algunos puestos de trabajo aún no han montado el recurso compartido NFS.
- Algunos puestos de trabajo han finalizado su restauración.
- Algunos clientes presentan identidades NFSv4 anómalas.
- Algunas conexiones no son visibles en el momento del diagnóstico.
Revise las identidades NFSv4, las sesiones y los informes de los puestos de trabajo afectados.
8. Ubicación de los registros
En el puesto de trabajo, los registros se almacenan en memoria y desaparecen al reiniciar el sistema. El diagnóstico los copia en la carpeta brut/logs/.
| Registro | En el puesto de trabajo | En el servidor | Contenido |
|---|---|---|---|
| DavOS | /var/log/davos.log |
davos-diag/<puesto>-<fecha>/brut/logs/ |
Inicio, montajes NFS, identidad NFS y acción solicitada. |
| Restauración | /var/log/davos_restorer.log |
debug_imaging/<puesto>/davos_restorer-<fecha>.log, en caso de error |
Comando ocs-sr, salida de Clonezilla y errores. |
| Captura | /var/log/davos_saver.log |
debug_imaging/<puesto>/ |
Comando de captura, compresión y velocidad de transferencia. |
| Clonezilla | /var/log/clonezilla.log |
brut/logs/ |
Proceso de restauración partición por partición. |
| Partclone | /var/log/clonezilla/partclone.log |
brut/logs/ |
Velocidad media y errores de lectura o de suma de comprobación. |
| Mensajes del núcleo | dmesg |
brut/dmesg.txt |
Red, controladores, errores de NVMe y NFS. |
| Imagen | — | masters/<UUID>/Info-saved-by-cmd.txt y clonezilla-img |
Comando de captura y parámetros de compresión. |
Rutas: las rutas del servidor son relativas a /var/lib/pulse2/imaging/logs/, salvo masters/, que es relativa a /var/lib/pulse2/imaging/.
8.1. Buscar rápidamente los errores de restauración
grep -inE 'error|fail|traceback|abort|no space|cannot' /var/log/davos_restorer.log | tail
8.2. Consultar las velocidades de transferencia de partclone
grep -oE 'Ave\. Rate: *[0-9.]+ *[GM]B/min' /var/log/clonezilla/partclone.log | tail -3
8.3. Examinar los mensajes del núcleo
dmesg | grep -iE 'link is up|nvme|nfs|firmware|hang' | tail -20
9. El puesto de trabajo no llega a arrancar DavOS
Si el puesto de trabajo no consigue arrancar DavOS, no se podrá generar ningún informe de diagnóstico del puesto de trabajo.
En ese caso, compruebe:
- Los mensajes que aparecen en pantalla.
- El funcionamiento del arranque PXE.
- Los registros de los servicios PXE y HTTP.
- La descarga del núcleo
vmlinuz. - La descarga de
initrd.img. - La carga de
fs.squashfs.
10. Información que debe facilitarse al servicio de asistencia de Medulla
Para permitir un análisis completo, remita:
- La carpeta de diagnóstico completa.
- El número de puestos de trabajo restaurados simultáneamente.
- La duración de la restauración.
- El nombre de la imagen restaurada.
Para crear un archivo comprimido:
tar czf davos-diag-$(hostname)-$(date +%Y%m%d).tar.gz -C /var/lib/pulse2/imaging/logs davos-diag
La carpeta que contiene los informes es:
/var/lib/pulse2/imaging/logs/davos-diag/
Confidencialidad: los informes pueden contener nombres de máquinas, direcciones IP, información sobre el hardware y rutas internas. Compruebe su contenido antes de enviarlos.
11. Resumen
El diagnóstico de DavOS permite identificar las principales causas de una restauración lenta o fallida:
- Velocidad de red insuficiente.
- Identidad o sesiones NFSv4 anómalas.
- Retransmisiones y latencia de NFS.
- Saturación del servidor NFS.
- Limitación relacionada con la descompresión.
- Limitación de partclone.
- Rendimiento insuficiente del disco de destino.
- Errores de hardware o de restauración.
Las herramientas davos-diag y davos-diag-serveur.sh se incluyen con el paquete medulla-davos-client en las versiones que incorporan esta funcionalidad.
El diagnóstico puede iniciarse de forma manual o automática durante las restauraciones.
A tener en cuenta: para diagnosticar eficazmente una descarga lenta de la imagen, compare los informes de varios puestos de trabajo con el del servidor Medulla. Este enfoque permite distinguir las limitaciones propias de un puesto de trabajo de los problemas de red, de sesiones NFS o de almacenamiento compartido.