Skip to main content

Preparar e instalar un servidor de relay Medulla

En esta página se describen los pasos para preparar un servidor destinado a convertirse en un servidor de relay Medulla.

Un servidor de relay se instala lo más cerca posible de las máquinas cliente. Permite, entre otras cosas, retransmitir las comunicaciones entre el servidor Medulla principal y las máquinas asociadas a él.

Un servidor de relay Medulla contiene, entre otros, los siguientes componentes:

  • un servidor XMPP;
  • un agente de relay;
  • un servidor Guacamole.

Nota:
Este procedimiento se refiere a la preparación del servidor antes de la instalación de los componentes de Medulla. La asignación de las máquinas al servidor de relay y la sincronización de los paquetes se tratan en las páginas siguientes de este capítulo.


1. Requisitos previos del servidor de relay

El servidor de relay debe cumplir los siguientes requisitos mínimos:

Componente Requisitos previos
Sistema operativo Debian 12.x
Arquitectura x86-64
CPU 4 núcleos
RAM 8 GB
Partición / 20 GB como mínimo – EXT4
Partición /var 400 GB como mínimo – XFS

El almacenamiento de /var también puede proporcionarse mediante un punto de montaje dedicado en una bahía o un volumen de almacenamiento externo.

Caso particular – Servidor de relay DMZ:
El espacio en disco del servidor de relay DMZ puede reducirse a 200 GB para /var.


2. Instalar Debian

Instale Debian 12.x en arquitectura x86-64.

Durante la instalación:

  • separe /var de /;
  • utilice LVM para los volúmenes;
  • utilice EXT4 para /;
  • utilice XFS para /var;
  • instale el servidor SSH;
  • instale las utilidades estándar del sistema.

Importante:
La documentación de instalación de Medulla recomienda no instalar ningún antivirus ni cortafuegos local en el servidor Debian antes de instalar Medulla.


3. Configurar el nombre del servidor

El servidor de relay debe disponer de un FQDN completo, compuesto por el nombre de host y el dominio.

Ejemplo:

relay-paris.example.local

Compruebe el nombre de host con:

hostname

A continuación, compruebe el FQDN con:

hostname -f

El resultado de hostname -f debe coincidir con el FQDN previsto para el servidor de relay.

Importante:
El FQDN debe estar correctamente definido antes de instalar Medulla.


4. Comprobar la resolución DNS

Compruebe que el servidor de relay pueda resolver el nombre del servidor Medulla principal.

Por ejemplo:

getent hosts FQDN_DEL_SERVIDOR_MEDULLA

Compruebe también que el FQDN del relay se resuelve correctamente:

getent hosts FQDN_DEL_RELAY

Resultado esperado:
Los nombres utilizados por la infraestructura de Medulla deben resolverse correctamente a las direcciones IP esperadas.


5. Configurar el direccionamiento de red

El servidor de relay debe disponer de una configuración de red estable.

Antes de la instalación, anote y compruebe:

  • la dirección IP del relay;
  • su máscara de red;
  • su puerta de enlace;
  • sus servidores DNS;
  • su FQDN.

Para visualizar las direcciones configuradas:

ip addr

Para visualizar la tabla de enrutamiento:

ip route

6. Crear la cuenta de instalación

En el marco de una instalación realizada por el equipo de Medulla, cree un usuario:

medulla

Por ejemplo:

adduser medulla

Esta cuenta debe tener permiso para utilizar sudo.

Añada el usuario al grupo correspondiente:

usermod -aG sudo medulla

La instalación automatizada requiere acceso a sudo sin solicitud de contraseña.

Importante:
El acceso con privilegios debe limitarse a la cuenta utilizada para la instalación y cumplir con las normas de seguridad de su organización.


7. Instalar la clave SSH de instalación

En el marco de una instalación asistida por Medulla, debe instalarse la clave pública SSH proporcionada para la cuenta medulla.

Cree el directorio SSH si es necesario:

mkdir -p /home/medulla/.ssh

A continuación, añada la clave pública facilitada en:

/home/medulla/.ssh/authorized_keys

Aplique los permisos adecuados:

chown -R medulla:medulla /home/medulla/.ssh
chmod 700 /home/medulla/.ssh
chmod 600 /home/medulla/.ssh/authorized_keys

Nota:
Utilice únicamente la clave SSH que se le haya facilitado para su instalación. No se debe copiar una clave pública de otra documentación o de otro entorno.


8. Comprobar el acceso SSH

Compruebe que el servidor SSH funciona:

systemctl status ssh

El servicio debe estar activo.

Compruebe también que la cuenta de instalación pueda iniciar sesión SSH en el servidor de relay.


9. Abrir los flujos de red

El servidor de relay debe poder comunicarse con el servidor Medulla principal.

En una infraestructura Medulla SaaS dedicada, la documentación actual requiere los siguientes flujos.

Del servidor Medulla al servidor de relay

Puerto Protocolo / Uso
5269 TCP / XMPP
22 TCP / SSH
22000 TCP / Syncthing
8081 TCP / HTTP(S)
9990 TCP / XML-RPC HTTPS

Del servidor de relay al servidor Medulla

Puerto Protocolo / Uso
5269 TCP / XMPP
22 TCP / SSH
22000 TCP / Syncthing
8443 TCP / HTTPS
22067 TCP / BEP-Relay/TLS
9999 TCP / XML-RPC HTTPS
7080 TCP / XML-RPC HTTPS

Atención:
Esta lista corresponde a los flujos actualmente documentados para añadir un relay a una infraestructura Medulla SaaS dedicada. Los flujos que deben autorizarse pueden depender de la arquitectura elegida. Para una instalación On-Premise, consulte el diagrama de flujos de red correspondiente a su arquitectura.


10. Comprobar la conectividad con el servidor Medulla

Antes de la instalación, compruebe que el servidor de relay pueda comunicarse con el servidor Medulla principal a través de los puertos requeridos por su arquitectura.

Por ejemplo:

nc -zv FQDN_DEL_SERVIDOR_MEDULLA 5269
nc -zv FQDN_DEL_SERVIDOR_MEDULLA 22000

Añada los demás puertos que correspondan a su entorno.

Resultado esperado:
Las conexiones necesarias entre el relay y el servidor Medulla principal deben estar autorizadas antes de iniciar la instalación del software.


11. Comprobar la fecha y la hora

Compruebe que la fecha y la hora del servidor sean correctas:

timedatectl

La sincronización de la hora debe funcionar correctamente.

Consejo:
Una hora del sistema incorrecta puede provocar comportamientos anómalos en determinados mecanismos de autenticación, certificados o comunicaciones entre servidores.


12. Comprobar el espacio en disco

Antes de la instalación, compruebe el particionado y el espacio disponible:

df -hT

Compruebe, en particular:

  • que / disponga del espacio previsto;
  • que /var esté correctamente separado;
  • que /var utilice XFS;
  • que su capacidad se corresponda con el tamaño previsto.

Para visualizar los volúmenes y los puntos de montaje:

lsblk -f

13. Comprobar los recursos del servidor

Compruebe la cantidad de memoria:

free -h

Compruebe el número de procesadores disponibles:

nproc

Para un servidor de relay estándar, los valores mínimos esperados son:

  • CPU: 4 núcleos
  • RAM: 8 GB

14. Comprobar IPv6

Antes de instalar Medulla, la documentación de instalación recomienda comprobar la configuración de IPv6 del servidor Debian.

En algunos entornos, una configuración de IPv6 inadecuada puede provocar problemas de conectividad o de resolución de direcciones de red.

Si es necesario desactivar IPv6, consulte la documentación de Medulla dedicada a la desactivación de IPv6 en Debian.


15. Ejecutar el script de verificación antes de la instalación

Medulla proporciona un script que permite comprobar la configuración del servidor antes de la instalación.

Descargue el script:

wget https://dl.medulla-tech.io/nc/check_server_before_install.sh

Haga que sea ejecutable:

chmod +x check_server_before_install.sh

A continuación, ejecútelo:

./check_server_before_install.sh

Resultado esperado:
Todas las comprobaciones del script deben superarse antes de continuar con la instalación de Medulla.


16. Información que debe prepararse antes de la instalación

Antes de iniciar la instalación del relay, prepare la siguiente información:

Información Ejemplo
Nombre de host relay-paris
FQDN relay-paris.example.local
Dirección IP Dirección IP del relay
Máscara / subred Red en la que se encuentra el relay
Puerta de enlace Puerta de enlace del servidor
DNS Servidores DNS utilizados
Servidor Medulla principal FQDN / dirección IP
Cuenta de instalación medulla si se trata de una instalación asistida
Clave SSH Clave facilitada para la instalación
Flujos de red Confirmación de su apertura

En el marco de una infraestructura SaaS dedicada, prepare también la entidad ITSM a la que debe asociarse el relay, en caso de que se desee una entidad distinta de la entidad matriz.


17. Instalación de los componentes de Medulla

Una vez que el servidor esté correctamente preparado, se podrán instalar los componentes de software de Medulla.

En el marco del procedimiento Medulla SaaS dedicado, el equipo de Medulla se encarga de la instalación del software del relay mediante Ansible.

A continuación, se genera un agente de Medulla para permitir que los puestos de trabajo correspondientes se conecten a dicho relay.

Nota:
El método de instalación de los componentes de Medulla depende del modo de despliegue de su infraestructura. Esta página se centra principalmente en la preparación del sistema que debe realizarse antes de este paso.


18. Comprobaciones tras la instalación

Una vez instalado el relay, no considere la instalación finalizada hasta que haya comprobado su correcto funcionamiento.

Compruebe, en particular:

  • que se pueda acceder al relay;
  • que los componentes de Medulla previstos estén en marcha;
  • que el relay se comunique con el servidor Medulla principal;
  • que esté correctamente registrado en Medulla;
  • que se le pueda asociar al menos una máquina;
  • que los paquetes necesarios puedan sincronizarse;
  • que se pueda llevar a cabo un despliegue de prueba.

Continuación:
Para llevar a cabo estas comprobaciones, consulte la página «Comprobación del correcto funcionamiento de un servidor de relay Medulla – Health Check».


19. Lista de comprobación de preparación

Comprobación Valor esperado
SO Debian 12.x
Arquitectura x86-64
CPU 4 núcleos como mínimo
RAM 8 GB como mínimo
/ 20 GB como mínimo – EXT4
/var 400 GB como mínimo – XFS
Relay DMZ /var puede reducirse a 200 GB
FQDN Configurado y operativo
DNS Resolución operativa
SSH Instalado y accesible
Cuenta de instalación Configurada con los permisos necesarios
Clave SSH Instalada si es necesario
Flujos de red Abiertos según la arquitectura
Fecha y hora Correctas y sincronizadas
Script de verificación Todas las pruebas requeridas superadas

20. Resumen

Antes de instalar un servidor de relay Medulla:

  1. prepare un servidor Debian 12.x con las especificaciones adecuadas;
  2. configure el particionado y, en particular, /var en XFS;
  3. configure un FQDN estable;
  4. compruebe la resolución de DNS y el enrutamiento;
  5. prepare el acceso SSH necesario para la instalación;
  6. abra los flujos correspondientes a su arquitectura;
  7. compruebe los recursos y la configuración del sistema;
  8. ejecute el script de verificación previo a la instalación;
  9. instale los componentes de Medulla según el modo de despliegue elegido;
  10. finalice con un Health Check completo del nuevo relay.

Recomendación:
No inicie la instalación del software del relay hasta que se hayan validado las comprobaciones de dimensionamiento, FQDN, DNS, SSH, almacenamiento y conectividad de red. Una buena preparación del servidor permite evitar la mayoría de los problemas que surgen durante la instalación y la conexión del relay.