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:
mysqlsshscppingipopensslpara 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:
- El idioma.
- El ámbito: máquinas OFF, ON, todas las máquinas o una lista específica.
- 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:
- Se realiza una copia de seguridad de la configuración de GLPI-Agent del Registro en un archivo
.reg. - Se instala el archivo MSI.
- Se comprueba la configuración tras la instalación.
- Si se ha modificado, se restaura tal y como estaba.
- 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_ATTENTEy consideración de los nombres NetBIOS truncados. - V41–V46: corrección de
medullanetnotifye 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,medullanetnotifyysshdaemon. - 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.iniyagentconf.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 filesen 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.