Skip to main content

Diagnosticar y corregir los agentes Medulla

Aplicable a: Servidor Medulla y agentes de Windows
Versión del script: V54 — 7 de noviembre de 2026
Entorno: Servidor Medulla bajo Linux, ejecución como root
Categoría: Diagnóstico, mantenimiento y corrección

1. Introducción

El script medulla_agents_V54.py permite realizar auditorías de los agentes Medulla instalados en los puestos de trabajo Windows, identificar anomalías y reparar automáticamente aquellas que admite, previa confirmación.

En particular, realiza lo siguiente:

  • La auditoría de las máquinas OFF y ON en Medulla.
  • El diagnóstico de las conexiones SSH y XMPP.
  • La comprobación de los servicios, archivos y configuraciones de los agentes.
  • El análisis de los inventarios de GLPI-Agent.
  • La detección de problemas relacionados con el DNS, la red y las actualizaciones automáticas.
  • La corrección de las anomalías admitidas.
  • La reparación opcional de GLPI-Agent.
  • La detección de puestos de trabajo presentes en la red pero que no figuran en Medulla.
  • La generación de informes detallados en formato HTML y CSV.

Importante: una auditoría no modifica ni los puestos de trabajo ni la base de datos de Medulla. Sin embargo, el informe web cifrado se publica de forma predeterminada, incluso en modo de auditoría. Utilice la opción --sans-publication para desactivar dicha publicación.

2. Descargar e instalar el script

El script está disponible en el servidor de descargas de Medulla, en la misma ubicación que las versiones anteriores.

Descarga de la versión V54:

Descargar medulla_agents_V54.py

Conéctese al servidor Medulla mediante SSH, con una cuenta que disponga de derechos de root, y a continuación ejecute:

cd /root
wget https://dl.medulla-tech.io/ma/medulla_agents_V54.py
chmod +x medulla_agents_V54.py
python3 -m py_compile medulla_agents_V54.py

Comprobar la integridad del archivo

sha256sum medulla_agents_V54.py | cut -c1-16

Huella de referencia facilitada para la V54: cad3a35669f65186 (los primeros 16 caracteres del SHA-256).

La versión publicada puede verificarse comparando esta huella con la del archivo descargado. En caso de diferencia, compruebe si el script se ha vuelto a publicar antes de ejecutarlo.

Requisitos previos

El servidor debe disponer de los siguientes comandos:

  • mysql
  • ssh
  • scp
  • ping
  • ip
  • openssl para la publicación cifrada

Si faltan algunas dependencias, el script le propondrá su instalación. La opción --installer permite instalarlas sin preguntas.

3. Ejecutar el script

Se recomienda ejecutar siempre el script en una sesión de screen, para que una interrupción de la conexión SSH no interrumpa la recopilación de datos.

screen -S medulla
cd /root
./medulla_agents_V54.py

Para desacoplar la sesión sin interrumpir el script, utilice Ctrl+A y, a continuación, D.

Para reanudar la sesión:

screen -r medulla

Sin opciones, el script muestra menús que le permiten elegir:

  1. El idioma.
  2. El ámbito: máquinas OFF, ON, todas las máquinas o una lista específica.
  3. El modo: solo auditoría, auditoría y acciones, máquinas ON sin inventario o detección de red.

En el modo de acciones, una pregunta adicional permite decidir si también deben tratarse las máquinas ON que, aunque estén operativas, presenten algún fallo.

4. Comandos principales

Auditoría sin corrección

Máquinas OFF:

./medulla_agents_V54.py --dry-run

Todo el parque:

./medulla_agents_V54.py --perimetre tout --dry-run

Una máquina concreta:

./medulla_agents_V54.py --cible PC1068 --dry-run

Varias máquinas:

./medulla_agents_V54.py --cible PC1068,10.0.0.12 --dry-run

Auditoría y corrección

Una máquina:

./medulla_agents_V54.py --cible PC1068 --oui

Todo el parque, incluidas las máquinas operativas que presenten defectos:

./medulla_agents_V54.py --perimetre tout --oui --full

Atención: --oui confirma las acciones sin preguntar y --full también autoriza el tratamiento de las máquinas en estado ON que funcionan correctamente. Se recomienda realizar primero una auditoría para examinar el plan de reparación.

Reparación de GLPI-Agent

./medulla_agents_V54.py --cible PC1068 --reparer-glpi

Para varios puestos de trabajo:

./medulla_agents_V54.py --cible PC1068,PC1069 --reparer-glpi

Para los puestos de trabajo en estado ON:

./medulla_agents_V54.py --perimetre on --reparer-glpi

Otros comandos útiles

Comando Función
--sans-inventaire --dry-run Auditar las máquinas ON sin UUID de inventario GLPI.
--fiche PC1068 Mostrar la ficha del último análisis sin realizar una nueva auditoría.
--reconfigurer Proponer la reconfiguración del agente en cuestión.
--comparaison-complete --dry-run Comparar todos los archivos del agente con la referencia del servidor.
--scan-reseau Buscar las máquinas presentes en la red.
--scan-reseau --scan-blocs Mostrar el plan de detección sin escanear.
--publier-dernier Volver a publicar el último informe con nuevas credenciales.
--sans-publication Desactivar la publicación del informe web.
--maj-script Comprobar e instalar la última versión publicada del script.
--sans-maj-script Omitir la comprobación de actualizaciones al iniciar el programa.
-v Activar los registros detallados.

5. Novedades de la V54

V54 — Reparación de GLPI-Agent sin el paquete Medulla

La V54 mejora la opción --reparer-glpi añadiendo un método alternativo para los casos en que el servidor no disponga de un paquete de despliegue de Medulla para GLPI-Agent.

El script busca primero el paquete GLPI-Agent entre los paquetes de Medulla, en particular en:

/var/lib/pulse2/packages/

Si no se encuentra ningún paquete adecuado, busca el MSI de GLPI-Agent más reciente, en versión 1.8 o superior, publicado por el servidor Medulla en la dirección:

http://<servidor>/downloads/win/downloads/

El puesto de trabajo descarga el MSI y lo instala sobre la versión existente.

Protección de la configuración:

  1. Se realiza una copia de seguridad de la configuración de GLPI-Agent del Registro en un archivo .reg.
  2. Se instala el archivo MSI.
  3. Se comprueba la configuración tras la instalación.
  4. Si se ha modificado, se restaura tal y como estaba.
  5. Se vuelve a leer la versión instalada, que debe ser, como mínimo, la 1.8.

La variable GLPI_MSI permite especificar un MSI concreto.

Si no hay ningún paquete ni MSI compatible disponible, el script no intentará realizar la instalación.

V53 — Resultado de la reparación en las fichas

La ficha de cada máquina incluye una línea «Reparación de GLPI-Agent» con uno de los siguientes estados:

Estado Significado
PAS_LANCEE Reparación no solicitada o solo auditoría.
AUCUN_PAQUET No hay ningún instalador compatible disponible.
ANNULE Reparación cancelada.
OK Reparación realizada.
ECHEC Reparación fallida.

Tras una reparación satisfactoria, la versión que aparece en los datos de la auditoría inicial puede permanecer sin cambios hasta el siguiente análisis.

V52 — Corrección en la lectura del deviceid

La lectura del deviceid de GLPI-Agent en un archivo .dump elimina ahora el byte inicial de longitud, independientemente de su valor. Esto evita la detección errónea de un puesto de trabajo clonado.

Otras mejoras importantes

  • V50–V51: exclusión de los registros obsoletos.
  • V49: diagnóstico detallado del puerto SSH 22 y de las reglas del cortafuegos de Windows, sin modificaciones.
  • V47–V48: estado RESET_EN_ATTENTE y consideración de los nombres NetBIOS truncados.
  • V41–V46: corrección de medullanetnotify e introducción de --reparer-glpi.
  • V34–V35: detección de red optimizada y cotejo con las sesiones XMPP.
  • V32: actualización automática verificada mediante SHA-256.
  • V30: detección de red, comparación selectiva de archivos y mejora del mecanismo de respaldo SSH.
  • V29: corrección de los diagnósticos erróneos de deviceid clonado.
  • V28: un GLPI-Agent antiguo o ausente ya no bloquea las reparaciones de Medulla.
  • V27: publicación cifrada del informe de forma predeterminada.

6. Funcionamiento de las conexiones

El script selecciona el protocolo de transporte más adecuado para cada máquina.

Estado del puesto de trabajo Método
Máquina OFF en Medulla SSH con la cuenta pulseuser y una clave.
Máquina ON en Medulla XMPP con una cuenta temporal de ejabberd y el complemento shellcommand.
Máquina ON muda en XMPP Recurso alternativo SSH.
Ficha OFF, pero puesto de trabajo realmente ON Uso de XMPP.
El programador de tareas rechaza la ejecución de XMPP Recurso alternativo SSH.

Se realiza una auditoría de una máquina ON cuyo agente responde correctamente en XMPP, pero no se modifica de forma predeterminada. Para corregir sus fallos, debe confirmar la pregunta que se le plantea o utilizar la opción --full.

7. Comprobaciones realizadas en los puestos de trabajo

Acceso y sistema

  • Respuesta del puesto de trabajo mediante ping, SSH o XMPP.
  • Identidad real del puesto de trabajo.
  • Derechos de administrador de la cuenta de inicio de sesión.
  • Versión de Windows y compatibilidad.
  • Estado OFF u ON en Medulla.

Agente Medulla

  • Presencia de Python y del agente.
  • Estado de los servicios medullaagent, medullanetnotify y sshdaemon.
  • Causas concretas de los fallos en el inicio de los servicios.
  • Detección de inscripciones antiguas en Python 2.7.
  • Comparación de versiones y archivos con la referencia del servidor.
  • Diagnóstico de la actualización automática.
  • Presencia de las bibliotecas, módulos y scripts necesarios.

Configuración y red

  • Validez de los archivos agentconf.ini y agentconf.ini.local.
  • Recopilación de Active Directory.
  • Existencia del directorio de registros.
  • Espacio disponible en disco.
  • Resolución DNS del servidor Medulla.
  • Conexión al servidor XMPP en el puerto 5222.
  • Conectividad con el servidor y el relay.
  • Diagnóstico del puerto SSH 22, de las reglas locales y de las reglas de GPO.

Inventario y registros

  • Presencia y funcionamiento de GLPI-Agent.
  • Versión de GLPI-Agent 1.8 o superior.
  • Coherencia del deviceid con el nombre del puesto de trabajo.
  • Antigüedad del último inventario.
  • Errores recientes en los registros.
  • Bucles de reconfiguración o reinicio.
  • Errores en la actualización automática.

8. Comprobaciones realizadas en el servidor

Las comprobaciones del servidor se realizan en modo de solo lectura.

  • Investigación sobre las máquinas inaccesibles.
  • Estado del puerto SSH de las máquinas accesibles a través de XMPP.
  • Configuración de la actualización automática.
  • Errores Too many open files en el relay.
  • Archivos de despliegue ausentes o incoherentes.
  • Errores de ejabberd y problemas de ancho de banda en c2s_shaper.
  • Faltan módulos y complementos.
  • UUID de inventario y deviceid duplicados.
  • Direcciones MAC compartidas o incluidas en la lista negra.
  • Máquinas ON sin inventario.
  • Restablecimientos y reconfiguraciones pendientes.
  • Reconexiones repetidas.
  • Estado de los sustitutos de Medulla.
  • Rechazos de SSH relacionados con AllowGroups.

9. Reparaciones gestionadas

Acción Solución
Corrección del agente Copia de seguridad, corrección de archivos o configuraciones, reinicio y comprobación.
Reparación de medullanetnotify Reinscripción del servicio a partir de una plantilla válida, con copia de seguridad del Registro.
Reparación de GLPI-Agent Únicamente con la opción --reparer-glpi, a través del paquete Medulla o del MSI de respaldo.
Recopilación de AD Sincronización del archivo en cuestión con la referencia del servidor, sin reversión a una versión anterior.
Reinicio del servicio Parada y arranque controlados.
Inicio de SSH Inicio de sshdaemon desde XMPP.
Inventario Solicitud de inventario cuando GLPI-Agent está disponible.
Restablecimiento Inscripción de una solicitud en reset_machine.
Reconfiguración Inscripción de need_reconf = 1.

Un restablecimiento solicitado para una máquina OFF permanece en espera hasta que vuelve a estar ON. En ese momento, aparece con el estado RESET_EN_ATTENTE y no se considera una reparación finalizada.

Tras la corrección, se vuelve a auditar el puesto de trabajo. Si la primera comprobación falla porque el agente se reinicia o porque el antivirus está analizando los archivos, se realiza un segundo intento tras 30 segundos con un tiempo de espera duplicado.

10. Detección de red

La detección de red busca las máquinas presentes en las subredes conocidas por Medulla, en particular aquellas que ya no están correctamente referenciadas.

./medulla_agents_V54.py --scan-reseau

Permite identificar:

  • Una máquina que haya cambiado de dirección IP.
  • Un puesto de trabajo accesible pero que figura como OFF en Medulla.
  • Un agente instalado en un puesto de trabajo que no figura en la base de datos.
  • Un rechazo de clave SSH.
  • Un puesto de trabajo Windows sin acceso SSH de Medulla.
  • Una máquina conectada mediante XMPP, pero inaccesible por SSH.

Para visualizar los bloques previstos sin realizar el escaneo:

./medulla_agents_V54.py --scan-reseau --scan-blocs

Precaución: aunque la detección es de solo lectura, genera tráfico de red que puede ser detectado por los equipos de seguridad. Avise al equipo de redes antes de realizar un primer escaneo de gran envergadura.

11. Informe HTML y publicación segura

Cada análisis genera un archivo rapport.html que contiene un resumen del parque informático y una ficha detallada por máquina.

El informe ofrece:

  • Contadores por estado.
  • Un resumen de las anomalías del servidor.
  • Problemas agrupados por tipo.
  • Una búsqueda por nombre, IP o descripción.
  • Filtros, ordenaciones y exportaciones a CSV.
  • Un plan de reparación priorizado para cada máquina.
  • Comandos de diagnóstico y corrección listos para copiar.

Acceso al informe publicado

Por defecto, se publica una copia cifrada en la dirección:

https://<servidor>/medulla-rapports/rapport.html

El script muestra al final del análisis un identificador y una contraseña aleatorios. Estos cambian con cada publicación y no se guardan.

El informe está comprimido y cifrado con AES-256 con protección HMAC. El navegador lo descifra tras introducir las credenciales.

Importante: abra la página mediante HTTPS. El descifrado no es posible mediante HTTP. Solo se publica la página cifrada; los archivos CSV y el informe local sin cifrar permanecen en el servidor.

Desactivar la publicación

./medulla_agents_V54.py --perimetre tout --dry-run --sans-publication

Volver a publicar el último informe

./medulla_agents_V54.py --publier-dernier

Este comando genera nuevas credenciales para el último informe disponible, sin volver a ejecutar una auditoría.

12. Archivos generados

Los archivos se guardan en:

/root/analyse/releve_<fecha>/
Archivo Contenido
rapport.html Informe HTML independiente sin cifrar.
fiches.json Fichas individuales de las máquinas.
resultats.csv Resultados detallados por puesto de trabajo.
statistiques.csv Estadísticas del análisis.
plan_de_remediation.csv Problemas y medidas recomendadas.
avant_apres_reparation.csv Comparación de los estados antes y después de la intervención.
enquete_postes_injoignables.csv Diagnóstico de puestos de trabajo inaccesibles.
reconnexions_en_boucle.csv Reconexiones repetidas.
uuid_inventaire_en_double.csv UUID de inventario compartidos.
mac_partagees.csv Direcciones MAC compartidas.
mac_blacklistees_a_reconfigurer.csv Máquinas que deben reconfigurarse tras su inclusión en la lista negra.
reconfiguration_mac.csv Resultados de las reconfiguraciones.
reset_d_office.csv Resultados de los restablecimientos.
fiches_off_obsoletes.csv Fichas OFF obsoletas.
glpi_agent_sans_full.csv GLPI-Agent anteriores a la versión 1.8.
decouverte_reseau.csv Resultados de la detección de red.
decouverte_xmpp_sans_ssh.csv Máquinas XMPP sin SSH accesible.
journaux/<puesto>.log Registro de acciones por máquina.
trace.log Registros detallados con la opción -v.

Los archivos CSV utilizan el separador punto y coma y la codificación UTF-8 con BOM.

13. Herramientas complementarias

medulla_extract_logs.py

Esta herramienta recopila y analiza los registros de los puestos de trabajo y del servidor en modo de solo lectura. Los datos confidenciales se ocultan en la información destinada al servicio de asistencia.

./medulla_extract_logs.py --depuis-releve /root/analyse
./medulla_extract_logs.py --cible NB554,NB648
./medulla_extract_logs.py --perimetre on --erreurs-seules
./medulla_extract_logs.py --sans-postes

El archivo de resumen destinado al servicio de asistencia se denomina:

A_ENVOYER_<fecha>.tar.gz

medulla_reconf_delai.py

Esta herramienta analiza los tiempos de reconfiguración y propone un valor para RECONF_ATTENTE.

./medulla_reconf_delai.py --appliquer medulla_agents_V54.py

Se crea una copia de seguridad con extensión .bak antes de realizar cualquier modificación.

14. Preguntas frecuentes

¿Puede el script modificar las máquinas durante una auditoría?

No. El modo --dry-run es de solo lectura para los puestos de trabajo y la base de datos de Medulla. No obstante, la publicación del informe web cifrado permanece activa de forma predeterminada.

¿Por qué no se repara una máquina ON que funciona correctamente?

Por motivos de seguridad, las máquinas en estado ON cuyo agente responde correctamente a través de XMPP no se modifican de forma predeterminada. Utilice la opción --full o confirme su procesamiento en el menú.

Falta GLPI-Agent o es anterior a la versión 1.8: ¿quedan bloqueadas las demás correcciones?

No. Las reparaciones del agente Medulla, los restablecimientos y las reconfiguraciones siguen siendo posibles. Solo se ignora la solicitud de inventario hasta que GLPI-Agent esté operativo.

¿Cómo se repara GLPI-Agent sin el paquete Medulla?

Desde la versión V54, la opción --reparer-glpi puede utilizar un MSI de GLPI-Agent compatible publicado en /downloads/win/downloads/ en el servidor Medulla. Se realiza una copia de seguridad de la configuración del Registro, que se restaura si es necesario.

¿Por qué el estado de GLPI-Agent indica PAS_LANCEE?

No se ha solicitado la reparación o el análisis se ha ejecutado en modo de solo auditoría.

¿Por qué pulseuser no permite la corrección?

Es posible que la cuenta haya dejado de pertenecer al grupo de Administradores locales, en particular debido a una GPO o a LAPS. Compruebe estos mecanismos y, a continuación, con los derechos adecuados, utilice:

Add-LocalGroupMember -SID S-1-5-32-544 -Member pulseuser

¿Qué significa RESET_EN_ATTENTE?

El restablecimiento se ha registrado en Medulla, pero el puesto de trabajo está OFF. La operación está a la espera de que vuelva a estar ON y no debe considerarse finalizada.

¿Qué significa ANNULE_SSH_PERDU?

La máquina respondía durante la auditoría, pero la conexión SSH ya no estaba disponible en el momento de la intervención. La acción se ha cancelado.

¿Por qué no se puede acceder al puerto 22?

La ficha permite distinguir entre un servicio SSH detenido, una regla del cortafuegos de Windows o un filtrado de red. El script no modifica las reglas del cortafuegos.

¿Por qué parece estar bloqueada la actualización automática del agente?

El diagnóstico puede detectar la ausencia de un descriptor o una anomalía en el relay. En caso de que se produzca el error Too many open files, se recomienda tratar el relay antes de iniciar un restablecimiento forzado.

¿Por qué no se abre el informe web?

Compruebe que la URL utilice HTTPS y que las credenciales coincidan con las del último análisis publicado.

¿Cómo se puede visualizar una ficha sin navegador?

./medulla_agents_V54.py --fiche PC1068

¿Cómo se vuelve a ejecutar la verificación tras una corrección?

./medulla_agents_V54.py --cible PC1068 --dry-run

¿Cómo se actualiza el script?

./medulla_agents_V54.py --maj-script

El mecanismo comprueba la huella SHA-256, la sintaxis y la versión antes de la instalación. Se conserva la copia anterior.

15. Normas de seguridad

  • Una auditoría no modifica ni los puestos de trabajo ni la base de datos.
  • Cualquier acción requiere una confirmación explícita o --oui.
  • Las máquinas operativas están protegidas de forma predeterminada.
  • Las correcciones se limitan al ámbito seleccionado.
  • Se comprueba la identidad del puesto de trabajo antes de intervenir.
  • Se realizan copias de seguridad de los archivos modificados.
  • No se elimina ningún archivo y el agente nunca se revierte a una versión anterior.
  • Las correcciones nunca se vuelven a aplicar automáticamente.
  • GLPI-Agent solo se repara con la opción --reparer-glpi.
  • Se realiza un diagnóstico del cortafuegos de Windows, pero nunca se modifica.
  • Se recomiendan las acciones de administración del relay y de ejabberd, pero no se ejecutan automáticamente.
  • Los secretos de configuración están protegidos.
  • La cuenta XMPP temporal se elimina al finalizar el proceso.

16. Ubicaciones y referencias

Elemento Dirección o ruta
Descarga manual V54 https://dl.medulla-tech.io/ma/medulla_agents_V54.py
Actualización automática https://d.medulla-tech.io/ma/
Manifiesto de actualización https://d.medulla-tech.io/ma/latest.json
MSI de GLPI-Agent en el servidor http://<servidor>/downloads/win/downloads/
Paquetes Medulla /var/lib/pulse2/packages/
Informes locales /root/analyse/
Informe web cifrado https://<servidor>/medulla-rapports/rapport.html
Plantilla medullanetnotify /root/analyse/reference_medullanetnotify.json

Versión documentada: Medulla Agents V54.
Huella SHA-256 de referencia (primeros 16 caracteres): cad3a35669f65186.
Documentación de Medulla: Diagnosticar y corregir los agentes Medulla.