Skip to main content

¿Por qué no se inscribe una máquina?

Al instalar un agente Medulla, la máquina debe inscribirse en el servidor para que pueda aparecer correctamente en la consola y utilizar las distintas funcionalidades de Medulla.

Si una máquina no se inscribe, se inscribe de forma incompleta o tarda un tiempo anormalmente largo en aparecer, se pueden comprobar varios aspectos.

Las principales causas documentadas son:

  • una incoherencia entre la información de la máquina y sus interfaces de red;
  • una interfaz de red incluida en la lista negra;
  • una dirección MAC duplicada;
  • una entrada de red huérfana en la base de datos de Medulla;
  • un problema con el agente subscription encargado de participar en el proceso de inscripción.

Nota:
Este procedimiento se aplica principalmente a las máquinas en las que está instalado el agente, pero cuya inscripción en Medulla no se completa correctamente. Si una máquina estaba inscrita correctamente anteriormente y ahora simplemente aparece sin conexión, consulte mejor la FAQ ¿Por qué una máquina aparece sin conexión?


1. Consultar los registros de inscripción

El primer paso consiste en consultar los registros de inscripción de Medulla.

Busque, en particular, el nombre de la máquina en cuestión y los mensajes que contengan:

Registering machine

incoherence between machines and network tables

Interface missing on machine

Registration incomplete for machine

Un error de inscripción puede, por ejemplo, generar una secuencia similar a la siguiente:

INFO - Registering machine poste-client-02@medulla-interne/...

WARNING - incoherence between machines and network tables

ERROR - Interface missing on machine poste-client-02@medulla-interne/...

ERROR - Registration incomplete for machine poste-client-02@medulla-interne/...

Atención:
El mensaje Registration incomplete es una consecuencia del problema. Las líneas que lo preceden suelen permitir identificar la causa del fallo en la inscripción.


2. Incoherencia entre las tablas machines y network

El mensaje:

incoherence between machines and network tables

indica una incoherencia entre la información de la máquina y la de sus interfaces de red registradas en Medulla.

Puede ir seguido de:

Interface missing on machine

Registration incomplete for machine

La guía de explotación de Medulla identifica varias causas posibles:

  • una interfaz de red incluida en la lista negra;
  • una duplicación de la dirección MAC;
  • una entrada presente en la tabla network cuando la máquina correspondiente ya no existe en la tabla machines.

3. Comprobar la información de red de la máquina

Para diagnosticar una incoherencia, comience por comparar la información de la que dispone Medulla con la configuración real de la máquina.

La información que debe comprobarse incluye, en particular:

  • el nombre de host;
  • la dirección IP;
  • la dirección MAC;
  • las interfaces de red presentes en la máquina.

Una incoherencia en la dirección MAC o en la interfaz utilizada puede impedir que Medulla complete correctamente la inscripción.

Consejo:
Cuando los registros muestren el mensaje Interface missing on machine, compare en primer lugar la dirección MAC indicada en los registros con las interfaces realmente presentes en la máquina.


4. Comprobar si hay entradas de red huérfanas

Puede existir una entrada en la tabla network aunque la máquina a la que estaba asociada ya no figure en la tabla machines.

Para buscar estas entradas:

SELECT *
FROM xmppmaster.network
WHERE machines_id NOT IN (
    SELECT id
    FROM xmppmaster.machines
);

Si esta consulta devuelve filas, significa que hay información de red huérfana en la base de datos.

Atención:
La presencia de una entrada devuelta por esta consulta no debe conllevar automáticamente su eliminación. Compruebe primero que se trata efectivamente de un dato que ya no es necesario y realice una copia de seguridad de la base de datos antes de realizar cualquier corrección.


5. Corregir las entradas de red huérfanas

Una vez confirmado que las entradas identificadas son efectivamente huérfanas, la guía de explotación de Medulla proporciona la siguiente consulta para eliminarlas:

DELETE FROM xmppmaster.network
WHERE machines_id NOT IN (
    SELECT id
    FROM xmppmaster.machines
);

Importante:
Este comando elimina directamente datos de la base de datos de Medulla. Su uso debe estar reservado a un administrador de Medulla, tras verificar el resultado de la consulta SELECT anterior y tras realizar una copia de seguridad de la base de datos.

Tras la corrección, deje que la máquina realice una nueva inscripción y compruebe los registros.


6. Buscar una dirección MAC duplicada

Una duplicación de la dirección MAC también puede provocar una incoherencia durante la inscripción.

Este caso puede darse, en particular, tras:

  • la duplicación de una máquina;
  • la creación de una máquina a partir de una imagen;
  • un cambio de tarjeta o de interfaz de red;
  • la conservación de una entrada antigua correspondiente a la máquina.

Cuando los registros señalen una incoherencia en la interfaz, compruebe si la dirección MAC en cuestión está asociada a varias entradas.

Nota:
La guía de explotación identifica la duplicación de direcciones MAC como una posible causa de Registration incomplete, pero no proporciona una consulta genérica de corrección para este caso. Por lo tanto, se recomienda identificar el origen de la duplicación antes de proceder a cualquier eliminación.


7. Comprobar si una interfaz figura en la lista negra

Una interfaz incluida en la lista negra también figura entre las causas documentadas que pueden provocar:

Interface missing on machine

Si la dirección MAC enviada por el agente es correcta, pero Medulla no conserva la interfaz correspondiente, compruebe si dicha interfaz cumple las reglas de exclusión utilizadas por la instalación.

Nota:
La guía de explotación identifica la interfaz incluida en la lista negra como una posible causa, pero no proporciona, en este procedimiento, la configuración exacta de la lista negra ni un comando para modificarla. Por lo tanto, es preferible no modificar la configuración sin haber identificado la regla en cuestión.


8. Caso de una máquina que tarda mucho en inscribirse

Otra situación documentada es la de una máquina que acaba inscribiéndose, pero solo tras un lapso de tiempo considerable que puede llegar a ser de aproximadamente una hora.

En este caso, el problema puede deberse a que el agente de subscription correspondiente no está disponible en XMPP.

En el registro del agente de la máquina, se puede encontrar un intento de suscripción:

subscribe to master_subsX agent

así como la presencia de la máquina:

presence_available poste-client-01@... available

En condiciones normales de funcionamiento, también debe aparecer una línea correspondiente a la presencia del agente de subscription.

presence_available agent@... Available

Si dicha presencia no aparece, compruebe el estado del componente de subscription.


9. Comprobar la presencia XMPP del agente de subscription

Desde el servidor ejabberd, utilice:

ejabberdctl connected_users | grep master_subsX

Sustituya master_subsX por el nombre del agente de subscription en cuestión.

Si el comando no devuelve ninguna línea, el agente de subscription esperado no está conectado a ejabberd.

Esto puede explicar por qué las máquinas tardan un tiempo anormalmente largo en completar su inscripción.

Atención:
Un proceso o un servicio puede parecer activo a nivel del sistema sin estar conectado correctamente a XMPP. Por lo tanto, la comprobación con connected_users permite verificar su presencia efectiva en ejabberd.


10. Reiniciar el componente de subscription

Si el agente de subscription esperado no aparece en:

ejabberdctl connected_users

la guía de explotación recomienda reiniciar el agente de subscription y, a continuación, volver a comprobar su conexión con ejabberd.

Tras el reinicio, compruebe:

ejabberdctl connected_users | grep master_subsX

y, a continuación, supervise la inscripción de la máquina.

Nota:
Si el componente sigue sin aparecer en connected_users a pesar de haberse reiniciado, el problema se encuentra en el componente de subscription o en su conexión XMPP y requiere un diagnóstico adicional.


11. Comprobar las inscripciones de una máquina

Para realizar un seguimiento de la actividad de inscripción, busque el nombre de la máquina en los registros de inscripción.

Las líneas que contengan:

Registering machine

permiten identificar los intentos de inscripción.

Un número anormalmente elevado de intentos para una misma máquina puede indicar que esta no consigue completar de forma duradera su proceso de inscripción.

En ese caso, busque en las líneas siguientes los mensajes:

incoherence between machines and network tables

Interface missing on machine

Registration incomplete for machine

12. No confundir los casos principales

Síntoma Causa que debe investigarse con prioridad
La máquina nunca se ha inscrito correctamente Agente, información de red y proceso de inscripción
Interface missing on machine Interfaz incluida en la lista negra, dirección MAC duplicada o incoherencia machines/network
Registration incomplete for machine Analizar los errores que preceden a este mensaje
La máquina acaba apareciendo tras un largo periodo de tiempo Comprobar el agente subscription
El agente de subscription se ha iniciado, pero la máquina no se inscribe Comprobar si aparece en ejabberdctl connected_users
La máquina estaba inscrita correctamente, pero ahora aparece sin conexión Diagnosticar el agente y su comunicación, en lugar de centrarse en la inscripción inicial

13. Procedimiento de diagnóstico rápido

Cuando una máquina no se inscribe en Medulla, realice las comprobaciones siguientes en este orden:

  1. comprobar que el agente Medulla está instalado y funciona en la máquina;
  2. consultar los registros de inscripción;
  3. buscar el mensaje Registration incomplete y los errores que lo preceden;
  4. si aparece el mensaje Interface missing, comprobar las interfaces y las direcciones MAC;
  5. buscar alguna incoherencia entre las tablas machines y network;
  6. buscar si hay alguna dirección MAC duplicada o alguna interfaz incluida en la lista negra;
  7. si la inscripción acaba funcionando, pero tras un largo retraso, comprobar el agente de subscription;
  8. comprobar si está presente con el comando ejabberdctl connected_users;
  9. una vez corregido el problema, dejar que el agente realice una nueva inscripción y comprobar los registros.

14. Tabla de diagnóstico rápido

Mensaje o síntoma Posible causa Primera comprobación
incoherence between machines and network tables Datos de máquina/red incoherentes Comprobar las tablas machines y network
Interface missing on machine Interfaz ausente, incluida en la lista negra o con dirección MAC incorrecta Comparar las interfaces y las direcciones MAC
Registration incomplete for machine Inscripción interrumpida por un error anterior Leer las líneas anteriores del registro
Entradas de red (network) sin máquina Datos de red huérfanos Ejecutar la consulta de comprobación
Dirección MAC utilizada varias veces Máquina o interfaz duplicadas Identificar las entradas que utilizan la misma dirección MAC
Inscripción tras un largo periodo de tiempo Agente de subscription no disponible Comprobar connected_users
master_subsX ausente en XMPP Agente de subscription no conectado Reiniciar el componente y comprobar su conexión

15. Información que debe recopilarse si el problema persiste

Si la máquina sigue sin inscribirse, recopile la siguiente información antes de continuar con el diagnóstico o de abrir un ticket de asistencia:

  • el nombre de host de la máquina;
  • su dirección IP;
  • sus direcciones MAC;
  • las líneas del registro correspondientes a Registering machine;
  • los posibles mensajes Interface missing;
  • los posibles mensajes Registration incomplete;
  • el resultado de la búsqueda de entradas huérfanas en network;
  • si la inscripción simplemente es muy lenta, la presencia o ausencia del agente subscription en ejabberdctl connected_users.

Recomendación:
Cuando una máquina no se inscriba, comience por buscar Registration incomplete en los registros y, a continuación, analice los mensajes que lo preceden. Un error Interface missing suele apuntar principalmente a las interfaces de red, las direcciones MAC o una incoherencia en los datos. Si la inscripción funciona, pero solo tras un retraso considerable, compruebe en primer lugar la presencia XMPP del componente subscription.