¿Por qué una máquina aparece sin conexión?
Una máquina puede aparecer sin conexión en Medulla aunque siga figurando en el inventario.
Este estado significa que Medulla ya no recibe correctamente la presencia del agente de la máquina.
Existen varias causas posibles:
- la máquina está realmente apagada o es inaccesible;
- el servicio MedullaAgent ha dejado de funcionar;
- el agente se está reconfigurando o se reinicia continuamente;
- se ha interrumpido la comunicación con Medulla;
- la máquina presenta un problema de inscripción;
- existe una incoherencia en la información de red de la máquina.
Nota:
Se recomienda comenzar por comprobar la máquina cliente y los registros de su agente antes de realizar modificaciones en el servidor Medulla.
1. Comprobar que la máquina esté realmente disponible
Comience por comprobar que la máquina está encendida y es accesible en la red.
Desde un equipo que pueda conectarse a la máquina:
ping IP_DE_LA_MAQUINA
Si la máquina no responde, compruebe, en particular:
- que esté encendida;
- que esté conectada a la red;
- que siga disponiendo de una dirección IP válida;
- que ningún filtro de red impida su comunicación con Medulla.
Nota:
La falta de respuesta al ping no siempre permite concluir que la máquina esté apagada, ya que algunos entornos pueden bloquear el protocolo ICMP. Esta prueba constituye únicamente una primera comprobación.
2. Consultar los registros del agente Medulla
En una máquina con Windows, el registro principal del agente Medulla es:
C:\Program Files\Medulla\var\log\xmpp-agent-machine.log
Este archivo permite, entre otras cosas, comprobar:
- el inicio del agente;
- los intentos de conexión;
- las operaciones de inscripción;
- las reconfiguraciones del agente;
- la presencia de errores recurrentes.
Cuando una máquina aparece sin conexión en Medulla, este registro constituye uno de los primeros elementos que deben analizarse.
3. Comprobar si el agente se reconfigura de forma repetida
La guía de explotación de Medulla indica que una máquina que ya no se comunica correctamente puede verse afectada por reconfiguraciones repetidas del agente.
En el registro:
C:\Program Files\Medulla\var\log\xmpp-agent-machine.log
busque el mensaje:
We start a reconfiguration of the medulla agent
Para contar el número de apariciones en Windows:
find /c "We start a reconfiguration of the medulla agent" "C:\Program Files\Medulla\var\log\xmpp-agent-machine.log"
Si este mensaje aparece un gran número de veces en el mismo archivo, por ejemplo, varias decenas de veces, esto puede indicar que el agente se está reconfigurando de forma anómala.
Atención:
Un reinicio o una reconfiguración puntual del agente no es necesariamente anormal. Es sobre todo la repetición frecuente de este comportamiento lo que debe analizarse.
4. Reiniciar el agente Medulla
Si los registros indican un comportamiento anómalo del agente, la guía de explotación propone reiniciarlo para comprobar si su funcionamiento se estabiliza.
En la máquina con Windows:
sc stop medullaagent
A continuación, cierre los procesos de Python aún activos relacionados con el agente si es necesario:
taskkill /F /IM python.exe
A continuación, reinicie el agente:
sc start medullaagent
Supervise el archivo:
C:\Program Files\Medulla\var\log\xmpp-agent-machine.log
para comprobar que el agente se reinicia con normalidad y que la máquina vuelve a conectarse a Medulla.
Atención:
El comando taskkill /F /IM python.exe detiene todos los procesos python.exe de la máquina. Solo debe utilizarse si ha comprobado que ninguna otra aplicación importante utiliza Python en el puesto de trabajo en cuestión.
5. Comprobar la cuenta XMPP de la máquina
Medulla utiliza XMPP para comunicarse con sus agentes.
En algunos casos documentados, cuando un agente se queda bloqueado en un ciclo de reconfiguración, puede ser necesario eliminar su antigua inscripción de ejabberd antes de permitir que el agente vuelva a inscribirse.
Desde el servidor ejabberd:
ejabberdctl unregister NOMBRE_DE_LA_CUENTA pulse
A continuación, reinicie el agente Medulla en la máquina:
sc start medullaagent
Atención:
La eliminación de una cuenta de ejabberd provoca la eliminación de su inscripción XMPP. Esta operación solo debe realizarse cuando se haya identificado claramente un problema de inscripción o de reconfiguración.
6. Comprobar el estado conocido de la máquina en Medulla
El último estado conocido de la máquina puede consultarse en la tabla uptime_machine.
SELECT *
FROM uptime_machine
WHERE hostname = "NOMBRE_DE_LA_MAQUINA"
ORDER BY id DESC
LIMIT 1\G;
El campo status indica el estado registrado:
1: se considera que la máquina está en línea;0: se considera que la máquina está apagada o sin conexión.
El campo updowntime indica el tiempo que lleva la máquina en ese estado.
Esta información permite, entre otras cosas, comparar el estado que se muestra en Medulla con la situación real de la máquina.
7. Comprobar si la máquina se reinicia o se vuelve a conectar de forma repetida
También es posible buscar en la base de datos xmppmaster las máquinas que aparecen varias veces como disponibles en un breve periodo de tiempo.
La guía de explotación proporciona la siguiente consulta:
SELECT COUNT(*) AS restartmach, hostname
FROM xmppmaster.uptime_machine
WHERE status = 1
AND updowntime < 100
AND date > (NOW() - INTERVAL 1 HOUR)
GROUP BY hostname
HAVING restartmach > 2;
Esta consulta permite identificar las máquinas que presentan varios cambios de estado en un intervalo de tiempo reducido y que podrían mostrar un comportamiento anómalo.
Nota:
La guía de explotación asocia esta consulta a la búsqueda de máquinas que puedan reiniciarse o volver a conectarse de forma repetida.
8. Comprobar la información de red de la máquina
Una incoherencia entre la información de la máquina y sus interfaces de red puede impedir su inscripción correcta.
Para visualizar la información de red conocida en Medulla:
SELECT
m.hostname,
m.ippublic,
m.ip_xmpp,
m.macaddress AS machine_mac,
n.ipaddress AS network_ip,
n.broadcast,
n.gateway,
n.mask,
n.mac AS network_mac
FROM xmppmaster.machines AS m
INNER JOIN xmppmaster.network AS n
ON n.machines_id = m.id
WHERE m.hostname = 'NOMBRE_DE_LA_MAQUINA';
Compruebe, en particular, la coherencia:
- del nombre de host;
- de la dirección IP;
- de la dirección MAC;
- de la información de la interfaz de red.
9. Caso de incoherencia entre machines y network
En algunos casos, la inscripción de una máquina puede fallar con mensajes similares a:
incoherence between machines and network tables
Interface missing on machine
Registration incomplete for machine
En la guía de explotación se mencionan varias causas:
- interfaz de red incluida en la lista negra;
- duplicación de la dirección MAC;
- entrada presente en la tabla
networksin una máquina correspondiente.
Para buscar entradas de red huérfanas:
SELECT *
FROM xmppmaster.network
WHERE machines_id NOT IN (
SELECT id FROM xmppmaster.machines
);
Atención:
Una anomalía en las tablas machines o network tiene más que ver con un problema de inscripción que con un simple estado sin conexión. La corrección de estas incoherencias se tratará en la sección de FAQ dedicada a la inscripción de máquinas.
10. Comprobar la asignación del servidor de relay
Una máquina debe disponer de un servidor de relay correctamente asignado para determinadas operaciones de Medulla.
La información de red obtenida anteriormente puede servir para comprobar si la máquina se encuentra en la red prevista.
El campo groupdeploy de la tabla machines contiene la información de asignación del relay utilizado para el despliegue.
Si la máquina presenta además errores tales como:
ABORT RELAY DOWN
ABORT INFO RELAY MISSING
deberá continuar el diagnóstico en el servidor de relay y su asignación.
11. No confundir una máquina sin conexión con un problema de inscripción
Dos situaciones diferentes pueden presentar síntomas similares:
| Situación | Interpretación |
|---|---|
| La máquina estaba conectada anteriormente, pero ya no se comunica | Diagnosticar principalmente el agente, la conectividad y XMPP |
| La máquina nunca ha aparecido correctamente en Medulla | Realizar un diagnóstico de su inscripción |
| La máquina aparece y desaparece de forma periódica | Comprobar si se está produciendo un reinicio o una reconfiguración repetida del agente |
Los registros contienen los mensajes Interface missing o Registration incomplete |
Comprobar si existe alguna incoherencia en la inscripción o en la interfaz de red |
12. Procedimiento de diagnóstico rápido
Cuando una máquina aparezca sin conexión en Medulla, realice las comprobaciones siguientes en este orden:
- comprobar que la máquina esté encendida y sea accesible;
- consultar el archivo
xmpp-agent-machine.log; - comprobar si el agente se reconfigura repetidamente;
- comprobar y, si es necesario, reiniciar el servicio MedullaAgent;
- comprobar el último estado de la máquina en
uptime_machine; - comprobar la coherencia de su información de red;
- si los registros indican un problema de inscripción, continuar con el procedimiento correspondiente.
13. Tabla de diagnóstico
| Síntoma | Comprobación | Acción |
|---|---|---|
| La máquina está físicamente apagada | Comprobar la alimentación eléctrica y la conexión a la red | Volver a poner la máquina en línea |
| Agente detenido | Comprobar MedullaAgent | Reiniciar el servicio |
| Reconfiguraciones repetidas | Buscar We start a reconfiguration... |
Diagnosticar el agente y su inscripción |
| Medulla considera que la máquina está sin conexión | Consultar uptime_machine |
Comparar con el estado real del puesto de trabajo |
| Falta la interfaz | Consultar machines y network |
Continuar con el diagnóstico de inscripción |
| Dirección MAC duplicada | Comprobar la información de red | Identificar la máquina duplicada |
| Relay incorrecto o no disponible | Comprobar la asignación del relay | Realizar un diagnóstico del servidor de relay |
14. Información que debe recopilarse si el problema persiste
Antes de continuar con el diagnóstico o de abrir un ticket de asistencia, recopile:
- el nombre de la máquina;
- su dirección IP;
- la fecha y la hora desde las que aparece sin conexión;
- el archivo
xmpp-agent-machine.log; - el estado del servicio MedullaAgent;
- el último estado disponible en
uptime_machine; - los posibles mensajes
Interface missingoRegistration incomplete; - el servidor de relay asociado a la máquina si el problema afecta también a los despliegues.
Recomendación:
Cuando una máquina aparezca sin conexión, comience por determinar si el problema proviene de la propia máquina, del agente Medulla o de su inscripción. La consulta del registro xmpp-agent-machine.log y del último estado conocido en uptime_machine suele permitir orientar rápidamente el diagnóstico.