Diagnosticar un servidor de relay Medulla
Los servidores de relay Medulla actúan como intermediarios entre el servidor Medulla principal y las máquinas cliente.
Se encargan, en particular, de distribuir órdenes y paquetes a las máquinas que tienen asignadas.
Cuando un relay experimenta un problema, los síntomas pueden ser:
- máquinas que ya no pueden recibir despliegues;
- paquetes que no están disponibles en determinadas máquinas;
- errores de tipo
ABORT RELAY DOWN; - errores
ABORT ALTERNATIVE RELAYS DOWN; - errores
ABORT INFO RELAY MISSING; - máquinas asociadas a un relay que ya no existe;
- un problema de sincronización de los paquetes.
Nota:
Un servidor de relay Medulla contiene, entre otros, un servidor XMPP, un agente de relay y un servidor Guacamole. Por lo tanto, el diagnóstico debe permitir distinguir si se trata de un problema de accesibilidad al servidor, de registro del relay, de asignación de máquinas o de distribución de paquetes.
1. Identificar el síntoma
Comience por determinar si el problema se refiere a:
| Síntoma | Diagnóstico prioritario |
|---|---|
ABORT RELAY DOWN |
Comprobar que el relay existe y que es accesible |
ABORT ALTERNATIVE RELAYS DOWN |
Comprobar los relays alternativos disponibles |
ABORT INFO RELAY MISSING |
Comprobar la asignación del relay a la máquina |
| Solo una máquina no funciona | Comprobar su campo groupdeploy y su regla de asignación |
| Todas las máquinas de un relay se ven afectadas | Comprobar en primer lugar el propio relay |
| Falta un paquete en un relay | Comprobar la distribución y la sincronización del paquete |
2. Comprobar que se pueda acceder al servidor de relay
En caso de error:
ABORT RELAY DOWN
la guía de explotación indica que el relay puede estar apagado o haber dejado de existir.
Comience por comprobar su accesibilidad en red:
ping IP_DEL_RELAY
A continuación, si se permite el acceso SSH:
ssh root@IP_DEL_RELAY
Nota:
La ausencia de respuesta al ping no permite, por sí sola, concluir que el servidor esté apagado, ya que algunos entornos pueden filtrar el protocolo ICMP. La prueba SSH permite completar el diagnóstico.
Si no se puede acceder al relay, compruebe:
- que esté encendido;
- que su dirección IP sea correcta;
- que el enrutamiento entre el servidor principal y el relay funcione;
- que los flujos necesarios no estén bloqueados.
3. Comprobar el último estado conocido del relay
Si el relay no responde, consulte su último estado registrado en Medulla:
SELECT *
FROM uptime_machine
WHERE hostname = "NOMBRE_DEL_RELAY"
ORDER BY id DESC
LIMIT 1\G;
El campo status indica su último estado conocido:
1: se considera que está en línea;0: se considera sin conexión.
El campo updowntime permite conocer el tiempo que el relay ha permanecido en ese estado.
4. Comprobar que el relay siga estando declarado y activado
Para visualizar los relays reconocidos por Medulla:
SELECT id, nameserver, enabled
FROM relayserver;
Compruebe, en particular:
- que el relay en cuestión aparezca en la lista;
- que su nombre se corresponda efectivamente con el servidor esperado;
- el valor de su campo
enabled.
Cuando:
enabled = 1
la guía de explotación indica que este relay puede ser proporcionado a las máquinas por el sustituto assessor.
Atención:
Un relay que ya no existe, pero que permanece activado en la configuración, puede seguir proponiéndose a las máquinas y provocar errores de despliegue.
5. Caso de un relay que ya no existe
Si ha confirmado que un relay se ha eliminado definitivamente o ya no se utiliza, la guía de explotación proporciona el siguiente comando para desactivarlo:
UPDATE relayserver
SET enabled = 0
WHERE id = <id_del_relay>;
Asimismo, indica que se compruebe la entrada correspondiente en la tabla machines:
SELECT id, enabled
FROM machines
WHERE hostname = 'NOMBRE_DEL_RELAY';
A continuación, si el servidor se ha retirado efectivamente:
UPDATE machines
SET enabled = 0
WHERE id = <id>;
Atención:
Estos comandos modifican directamente la base de datos de Medulla. Solo deben utilizarse cuando se haya confirmado que el relay se ha retirado definitivamente, tras realizar una copia de seguridad de la base de datos.
6. Diagnosticar ABORT RELAY DOWN
El estado:
ABORT RELAY DOWN
indica que Medulla no puede utilizar el relay previsto para el despliegue.
Realice las comprobaciones siguientes:
- comprobar el relay con el comando
ping; - comprobar su acceso SSH;
- comprobar su estado más reciente en
uptime_machine; - comprobar si figura en
relayserver; - comprobar el valor de
enabled; - si se ha eliminado el relay, comprobar que ya no se propone a las máquinas.
7. Diagnosticar ABORT ALTERNATIVE RELAYS DOWN
El estado:
ABORT ALTERNATIVE RELAYS DOWN
significa que no hay disponible ningún relay alternativo que pueda utilizarse.
La guía de explotación recomienda, en este caso, comprobar los relays.
Para cada uno de los relays que puedan utilizarse:
- compruebe su accesibilidad en la red;
- compruebe su último estado conocido;
- compruebe que sigue activado en
relayserver.
Nota:
Si varios relays dejan de estar disponibles simultáneamente, busque también un problema común de red o de infraestructura, en lugar de un fallo individual de cada relay.
8. Diagnosticar ABORT INFO RELAY MISSING
El estado:
ABORT INFO RELAY MISSING
indica que falta la información relativa al relay asociado a la máquina.
La guía de explotación señala, entre otros, el siguiente caso posible:
- un relay eliminado tras haber sido asignado a la máquina;
- una máquina cuyo campo
groupdeployno está rellenado.
El campo:
groupdeploy
de la tabla machines contiene el JID del relay asociado a la máquina.
Por lo tanto, compruebe que la máquina disponga efectivamente de un valor en groupdeploy.
Por ejemplo:
SELECT id, hostname, groupdeploy
FROM machines
WHERE hostname = 'NOMBRE_DE_LA_MAQUINA';
Si groupdeploy está vacío, la máquina no está asociada a ningún relay.
9. Comprobar que el relay indicado en groupdeploy existe
No basta con que haya un valor en groupdeploy: este debe corresponder a un relay que siga existiendo.
Visualice los relays disponibles:
SELECT id, nameserver, jid, enabled
FROM relayserver;
A continuación, compare el JID del relay con el valor de groupdeploy de la máquina.
Atención:
Si groupdeploy hace referencia a un relay antiguo que se ha eliminado, Medulla puede devolver el mensaje ABORT INFO RELAY MISSING.
10. Corregir una máquina sin relay asociado
Una vez identificado el relay correcto, la guía de explotación ofrece el siguiente ejemplo:
UPDATE machines
SET groupdeploy = 'agent@medulla-interne/mainrelay'
WHERE id = <id_maquina>;
El valor utilizado debe coincidir con el JID del relay adecuado que figura en la tabla relayserver.
Atención:
Esta consulta modifica directamente la asignación de una máquina. No debe aplicarse sin haber identificado previamente el motivo por el que la asignación automática no ha funcionado. De lo contrario, el problema podría volver a producirse durante una próxima reconfiguración.
11. Comprobar la regla de asignación del relay
Medulla puede asignar las máquinas a un relay en función de reglas de red.
La guía de explotación ofrece un ejemplo que permite comprobar si una subred se ajusta a una expresión regular definida en las reglas de asignación:
SELECT '10.10.19.0/24'
REGEXP '^10\.62\.19\.0\/24$';
En este ejemplo:
10.10.19.0/24corresponde a la subred de la máquina;^10\.62\.19\.0\/24$se corresponde con la regla que se va a comprobar.
El resultado permite determinar si la subred se ajusta o no a la regla.
Consejo:
Si varias máquinas de una misma red están asignadas al relay incorrecto, busque en primer lugar un error en la regla de asignación, en lugar de una anomalía individual en cada máquina.
12. Comprobar la información de red de la máquina
Para comprender por qué una máquina recibe o no un relay concreto, puede consultar su información de red tal y como la conoce 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, que la red detectada por la máquina se corresponda con la red prevista por la regla de asignación del relay.
13. Identificar los relays sin ninguna máquina asociada
Para obtener una lista de los relays que no tienen ningún cliente asociado, la guía de explotación proporciona la siguiente consulta:
SELECT nameserver
FROM relayserver
WHERE relayserver.jid NOT IN (
SELECT groupdeploy
FROM machines
WHERE agenttype = 'machine'
);
Esta consulta permite identificar los relays que están actualmente declarados, pero que no son utilizados por ninguna máquina.
Nota:
Un relay sin cliente no tiene por qué estar en error. Puede haberse instalado en previsión de una nueva sede o utilizarse como relay alternativo. Por lo tanto, esta consulta debe interpretarse en el contexto de la arquitectura.
14. Comprobar la disponibilidad de los paquetes en el relay
Cuando se pueda acceder a un relay pero no sea posible realizar el despliegue de un paquete, compruebe que el paquete esté disponible en el servidor utilizado para su distribución.
Un error como el siguiente:
Transfer error: Package Server does not have this package
indica que el servidor de paquetes utilizado no dispone del paquete solicitado.
En esta situación, el problema no significa necesariamente que el propio relay esté sin conexión.
Es necesario distinguir entre:
| Error | Interpretación |
|---|---|
ABORT RELAY DOWN |
El relay no está disponible |
ERROR TRANSFER FAILED |
El servidor utilizado no dispone del paquete |
ABORT TRANSFER FAILED |
La transferencia del paquete ha fallado |
15. Comprobar Syncthing en caso de que surja algún problema de sincronización
La guía de explotación de Medulla recoge un caso en el que Syncthing muestra un error relacionado con el tamaño del búfer UDP:
failed to sufficiently increase receive buffer size
(was: 208 kiB, wanted: 2048 kiB, got: 416 kiB)
En este caso concreto, se recomienda aumentar los tamaños máximos de los búferes de lectura y escritura:
sysctl -w net.core.rmem_max=2500000
sysctl -w net.core.wmem_max=2500000
Atención:
Estos comandos corresponden a un problema concreto de Syncthing, identificable por el mensaje de error anterior. No deben aplicarse de forma sistemática a cualquier problema de sincronización.
16. Determinar si el problema proviene del relay o de la máquina
Antes de intervenir en el relay, determine el alcance del problema.
| Constatación | Orientación del diagnóstico |
|---|---|
| Solo se ve afectada una máquina | Comprobar la máquina y su groupdeploy |
| Varias máquinas del mismo relay se ven afectadas | Comprobar el relay |
| Todas las máquinas de una subred están mal asignadas | Comprobar la regla de asignación |
| Las máquinas se comunican, pero faltan algunos paquetes | Comprobar la disponibilidad y la sincronización de los paquetes |
| No se puede acceder al relay | Comprobar el servidor y los flujos de red |
17. Procedimiento de diagnóstico rápido
Cuando un servidor de relay Medulla parezca tener un problema, realice las comprobaciones siguientes en este orden:
- identificar las máquinas y las funciones afectadas;
- anotar el estado exacto del despliegue, si existe;
- comprobar la accesibilidad del relay mediante el comando
pingy SSH; - comprobar su estado más reciente en
uptime_machine; - comprobar su presencia y su estado
enabledenrelayserver; - comprobar el campo
groupdeployde las máquinas afectadas; - comprobar que el JID de
groupdeploycorresponda a un relay existente; - si la asignación parece incorrecta, comprobar la regla de asignación;
- si solo se ven afectados los paquetes, comprobar su disponibilidad y su sincronización;
- consultar los registros de Syncthing si se sospecha de un error de sincronización.
18. Tabla de diagnóstico rápido
| Síntoma | Posible causa | Primera comprobación |
|---|---|---|
ABORT RELAY DOWN |
Relay apagado o eliminado | ping, SSH y uptime_machine |
ABORT ALTERNATIVE RELAYS DOWN |
No hay ningún relay alternativo disponible | Comprobar los distintos relays |
ABORT INFO RELAY MISSING |
Relay ausente o groupdeploy vacío |
Comprobar el groupdeploy |
| Relay conocido pero ya no utilizado | Entrada antigua aún activada | Comprobar relayserver.enabled |
| Máquina asignada al relay incorrecto | Regla de asignación incorrecta | Comprobar la subred con la regla REGEXP |
| Relay sin ninguna máquina | Relay no utilizado o de reserva | Consulta sobre groupdeploy |
| Paquete ausente en el relay | Problema de distribución o sincronización | Comprobar la disponibilidad del paquete |
| Error de búfer de Syncthing | Búfer UDP insuficiente | Buscar el mensaje exacto en los registros |
19. Información que debe recopilar si el problema persiste
Antes de continuar con el diagnóstico o de abrir un ticket de asistencia, recopile:
- el nombre de host del relay;
- su dirección IP;
- el resultado de la prueba de accesibilidad;
- su último estado en
uptime_machine; - su entrada en
relayserver; - el valor de
enabled; - el nombre de host de una máquina afectada;
- el valor de
groupdeployde dicha máquina; - el estado exacto del despliegue;
- el mensaje completo de la auditoría;
- si el problema afecta a los paquetes, el paquete y el relay en cuestión;
- los posibles errores de Syncthing observados.
Recomendación:
Para diagnosticar un relay Medulla, comience por distinguir tres aspectos: ¿se puede acceder al relay?, ¿está la máquina correctamente asociada a dicho relay? y ¿dispone el relay de los recursos necesarios para el despliegue? Este enfoque permite distinguir rápidamente una avería del servidor de relay de un problema de asignación o de sincronización de los paquetes.