Skip to main content

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 root al servidor Medulla.
  • Para el diagnóstico manual, acceso SSH con privilegios de root a 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:

  1. DavOS se inicia con normalidad.
  2. Se inicia la restauración con Clonezilla.
  3. El diagnóstico espera a que se inicie partclone.
  4. Se mide el rendimiento durante el tiempo configurado.
  5. Los resultados se registran en el servidor.
  6. 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:

  1. La identidad y las sesiones NFSv4.
  2. Las retransmisiones y las expiraciones de NFS.
  3. La latencia de NFS.
  4. Los subprocesos de nfsd.
  5. La espera del disco del servidor.
  6. 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.