¿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
subscriptionencargado 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
networkcuando la máquina correspondiente ya no existe en la tablamachines.
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:
- comprobar que el agente Medulla está instalado y funciona en la máquina;
- consultar los registros de inscripción;
- buscar el mensaje
Registration incompletey los errores que lo preceden; - si aparece el mensaje
Interface missing, comprobar las interfaces y las direcciones MAC; - buscar alguna incoherencia entre las tablas
machinesynetwork; - buscar si hay alguna dirección MAC duplicada o alguna interfaz incluida en la lista negra;
- si la inscripción acaba funcionando, pero tras un largo retraso, comprobar el agente de
subscription; - comprobar si está presente con el comando
ejabberdctl connected_users; - 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
subscriptionenejabberdctl 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.