Skip to main content

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:

  1. comprobar el relay con el comando ping;
  2. comprobar su acceso SSH;
  3. comprobar su estado más reciente en uptime_machine;
  4. comprobar si figura en relayserver;
  5. comprobar el valor de enabled;
  6. 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 groupdeploy no 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/24 corresponde 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:

  1. identificar las máquinas y las funciones afectadas;
  2. anotar el estado exacto del despliegue, si existe;
  3. comprobar la accesibilidad del relay mediante el comando ping y SSH;
  4. comprobar su estado más reciente en uptime_machine;
  5. comprobar su presencia y su estado enabled en relayserver;
  6. comprobar el campo groupdeploy de las máquinas afectadas;
  7. comprobar que el JID de groupdeploy corresponda a un relay existente;
  8. si la asignación parece incorrecta, comprobar la regla de asignación;
  9. si solo se ven afectados los paquetes, comprobar su disponibilidad y su sincronización;
  10. 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 groupdeploy de 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.