Skip to main content

Health Check de un servidor Medulla

Este procedimiento permite comprobar rápidamente el correcto funcionamiento de un servidor Medulla y de sus principales componentes.

En concreto, puede utilizarse:

  • tras un reinicio del servidor;
  • tras una operación de mantenimiento;
  • tras una actualización de Medulla;
  • tras un cambio en la configuración;
  • cuando se sospeche de un fallo general de la plataforma.

Nota:
El objetivo de este Health Check es confirmar rápidamente que los principales componentes de Medulla están operativos. Si falla alguna de las comprobaciones, consulte los registros del componente en cuestión antes de reiniciar o modificar el servicio.


1. Comprobar el acceso a la interfaz de Medulla

Empiece por iniciar sesión en la interfaz web de Medulla.

Compruebe, en particular, que:

  • se pueda acceder a la página de inicio de sesión;
  • la autenticación funciona;
  • la interfaz principal se cargue correctamente;
  • las máquinas aparecen en el inventario.

Resultado esperado:
El administrador puede iniciar sesión en Medulla y consultar con normalidad el inventario de máquinas.


2. Comprobar el estado de los principales servicios de Medulla

Compruebe el estado de los principales servicios de Medulla con systemctl.

systemctl status ejabberd
systemctl status mmc-agent
systemctl status pulse-xmpp-agent-relay
systemctl status pulse2-register-pxe
systemctl status pulse2-package-server
systemctl status pulse-xmpp-master-substitute-master
systemctl status pulse-xmpp-master-substitute-logger
systemctl status pulse-xmpp-master-substitute-updates
systemctl status pulse-xmpp-master-substitute-assessor
systemctl status pulse-xmpp-master-substitute-inventory
systemctl status pulse-xmpp-master-substitute-deployment
systemctl status pulse-xmpp-master-substitute-monitoring
systemctl status pulse-xmpp-master-substitute-registration
systemctl status pulse-xmpp-master-substitute-subscription

Para una comprobación más rápida, utilice:

systemctl is-active NOMBRE_DEL_SERVICIO

El resultado esperado es:

active

Atención:
Dependiendo de la instalación de Medulla y de las funcionalidades activadas, es posible que algunos servicios no estén presentes. Por lo tanto, la ausencia de un servicio opcional no indica necesariamente un fallo de funcionamiento.


3. Identificar rápidamente los servicios que presentan errores

Para buscar los servicios que actualmente presentan fallos:

systemctl --failed

Si aparece un servicio de Medulla en esta lista, compruebe su estado:

systemctl status NOMBRE_DEL_SERVICIO

y, a continuación, sus últimos registros:

journalctl -u NOMBRE_DEL_SERVICIO -n 100

Consejo:
No reinicie sistemáticamente un servicio que presente un error antes de haber consultado sus registros. Los mensajes presentes antes del reinicio pueden ser esenciales para identificar la causa del incidente.


4. Comprobar ejabberd y XMPP

Medulla utiliza XMPP para comunicarse con sus agentes y con varios de sus componentes internos.

Compruebe que el servicio ejabberd funciona:

systemctl is-active ejabberd

El resultado esperado es:

active

A continuación, consulte el número de usuarios conectados actualmente:

/usr/bin/ejabberdctl stats onlineusers

y el número de usuarios registrados:

/usr/bin/ejabberdctl stats registeredusers

Para ver los usuarios conectados actualmente:

ejabberdctl connected_users

Resultado esperado:
ejabberd está activo y los agentes y componentes de Medulla previstos están conectados a XMPP.


5. Comprobar MariaDB

Compruebe que el servicio MariaDB esté activo:

systemctl is-active mariadb

El resultado esperado es:

active

A continuación, compruebe que MariaDB acepta correctamente las consultas:

mariadb -e "SELECT 1;"

El resultado esperado contiene:

1
1

6. Comprobar el servidor de paquetes

Compruebe el servicio del servidor de paquetes:

systemctl is-active pulse2-package-server

El resultado esperado es:

active

Compruebe también desde la interfaz de Medulla que un paquete existente se vea correctamente.


7. Comprobar el servidor de relay

Si el servidor también actúa como servidor de relay, compruebe lo siguiente:

systemctl is-active pulse-xmpp-agent-relay

El resultado esperado es:

active

En una arquitectura con varios relays, compruebe también que se pueda acceder a los relays previstos.

La indisponibilidad de un relay puede provocar, entre otras cosas:

ABORT RELAY DOWN
ABORT ALTERNATIVE RELAYS DOWN

8. Comprobar Syncthing

Cuando se utilice Syncthing para la sincronización de paquetes, compruebe su estado:

systemctl is-active syncthing@syncthing

El resultado esperado es:

active

Atención:
Un servicio Syncthing activo no garantiza por sí solo que todos los paquetes estén correctamente sincronizados. En caso de error de transferencia o de que falte un paquete en un relay, compruebe también que la sincronización se haya realizado correctamente.


9. Comprobar el espacio en disco

Compruebe el espacio disponible en los sistemas de archivos:

df -h

Preste especial atención al sistema de archivos que contiene los paquetes de despliegue.

Importante:
La saturación del repositorio de un relay puede impedir la sincronización o la distribución de nuevos paquetes sin que ello implique necesariamente la interrupción de un servicio.


10. Comprobar los recursos del servidor

Compruebe la memoria disponible:

free -h

A continuación, compruebe la carga del servidor:

uptime

Para obtener una visión dinámica:

top

Compruebe, en particular:

  • la memoria disponible;
  • el uso del swap;
  • la carga del sistema;
  • la presencia de algún proceso que consuma recursos de forma anómala.

11. Comprobar que una máquina se comunica con Medulla

Desde la interfaz de Medulla, seleccione una máquina de la que se sepa que está encendida y compruebe que aparece como en línea.

Esta comprobación permite validar de forma sencilla la cadena de comunicación:

Agent
  ↓
Réseau
  ↓
XMPP / ejabberd
  ↓
Medulla

Si todas las máquinas aparecen sin conexión a pesar de estar encendidas, busque en primer lugar un problema general de comunicación o de servicio.


12. Comprobar el inventario

Seleccione una máquina de prueba y compruebe que su información de inventario esté disponible en Medulla.

Compruebe, por ejemplo:

  • el nombre de host;
  • el sistema operativo;
  • la información de red;
  • el software instalado.

Resultado esperado:
La información de inventario de la máquina está disponible y es coherente.


13. Probar un despliegue

Tras un mantenimiento importante o una actualización, se recomienda realizar un despliegue en una máquina de prueba.

Utilice preferiblemente un paquete sencillo que no tenga un impacto funcional significativo.

El despliegue debe concluir con:

DEPLOYMENT SUCCESS

Esta prueba valida, en particular:

  • la comunicación con el agente;
  • la asignación del relay;
  • la disponibilidad del paquete;
  • la transferencia;
  • la ejecución en la máquina de destino.

14. Consultar los errores recientes

Incluso cuando todos los servicios estén activos, compruebe si hay errores recientes en los registros.

Para un servicio:

journalctl -u NOMBRE_DEL_SERVICIO -n 100

Para visualizar los errores desde el último arranque:

journalctl -p err -b

Nota:
Un servicio puede estar active, aunque presente errores de funcionamiento. Por lo tanto, el estado de systemd no siempre es suficiente para confirmar el correcto funcionamiento del componente.


15. Lista de comprobación rápida

Comprobación Resultado esperado
Interfaz web Accesible
Autenticación Funcional
Servicios de Medulla Activos
systemctl --failed Ningún servicio de Medulla crítico presenta errores
ejabberd Activo
XMPP Componentes previstos conectados
MariaDB Activo y accesible
Servidor de paquetes Activo
Servidor de relay Activo y accesible
Syncthing Activo si se utiliza
Espacio en disco Espacio disponible suficiente
Memoria / carga Sin saturación
Máquina de pruebas En línea
Inventario Disponible
Despliegue de prueba DEPLOYMENT SUCCESS

16. ¿Qué se debe hacer si falla una comprobación?

Problema detectado Diagnóstico a seguir
Servicio Medulla inactivo Consultar systemctl status y, a continuación, journalctl
ejabberd no está disponible Diagnosticar el servicio XMPP
Componente ausente de connected_users Diagnosticar su conexión XMPP
MariaDB no está disponible Consultar el estado y los registros de MariaDB
Relay no disponible Diagnosticar el servidor de relay
Falta un paquete en un relay Comprobar Syncthing y la sincronización
Máquina sin conexión Consultar la FAQ «¿Por qué aparece una máquina sin conexión?»
Máquina no registrada Consultar la FAQ «¿Por qué no se registra una máquina?»
Error en el despliegue Consultar el estado y la auditoría del despliegue

17. Resumen

Un servidor Medulla puede considerarse operativo en general cuando:

  • se puede acceder a la interfaz web;
  • los servicios principales estén activos;
  • ejabberd funciona;
  • los componentes previstos están conectados a XMPP;
  • MariaDB está en funcionamiento;
  • los servidores de relay están disponibles;
  • los paquetes están accesibles y sincronizados;
  • los recursos del sistema no están saturados;
  • al menos una máquina se comunica con normalidad con Medulla;
  • el inventario funciona;
  • se puede realizar con éxito un despliegue de prueba.

Recomendación:
Tras un mantenimiento o una actualización importante, no se limite a comprobar que los servicios estén active. Verifique también el funcionamiento de principio a fin con una máquina conectada, una actualización del inventario y un despliegue de prueba.