Skip to main content

¿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 network sin 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:

  1. comprobar que la máquina esté encendida y sea accesible;
  2. consultar el archivo xmpp-agent-machine.log;
  3. comprobar si el agente se reconfigura repetidamente;
  4. comprobar y, si es necesario, reiniciar el servicio MedullaAgent;
  5. comprobar el último estado de la máquina en uptime_machine;
  6. comprobar la coherencia de su información de red;
  7. 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 missing o Registration 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.