Skip to main content

Relays – Hacer visibles los relays para todos los usuarios

Aplicable a: Servidor Medulla
Versión: Medulla 5.6.x
Entorno: On-Premise / Debian 12 / MariaDB
Categoría: Administración / Gestión de relays
Script: enable_relay_display.sh

En esta FAQ se explica cómo utilizar el script enable_relay_display.sh para que los relays de Medulla sean visibles para todos los usuarios.

Presenta las diferentes posibilidades de uso del script: ejecución puntual, automatización, simulación, consulta del estado, anulación de los cambios y reactivación.

Nota:
El script permite que los relays de Medulla sean visibles para todos los usuarios añadiendo las reglas globales que faltan.
No modifica la configuración de los relays ni vuelve a crear las reglas ya existentes.

Uso de sudo:
Todos los comandos que requieran derechos de administrador se presentan con sudo.
El usuario que haya iniciado sesión debe disponer de los permisos necesarios para ejecutar dichos comandos.


1. Requisitos previos

Antes de utilizar el script, compruebe los siguientes puntos:

  • Disponer de un servidor Medulla On-Premise.
  • Utilizar un entorno Debian compatible, en particular Debian 12.
  • Disponer de un servidor MariaDB compatible.
  • Tener acceso a las bases de datos de Medulla.
  • Disponer de los derechos de administrador necesarios.
  • Poder ejecutar comandos con sudo.

El script realiza automáticamente varias comprobaciones antes de modificar la configuración.

Atención:
Antes de ejecutarlo por primera vez en un servidor de producción, se recomienda realizar una copia de seguridad de las bases de datos de Medulla.
Para su primer uso, comience por el modo de simulación.


2. Instalar el script

Descargar el script en el servidor Medulla

Inicie sesión en el servidor Medulla con un usuario que disponga de permisos de sudo y, a continuación, descargue el script oficial.

sudo wget -O /root/enable_relay_display.sh https://dl.medulla-tech.io/ma/enable_relay_display.sh

En los ejemplos de esta FAQ, el script se encuentra en el directorio:

/root/enable_relay_display.sh

Hacer que el script sea ejecutable

sudo chmod 700 /root/enable_relay_display.sh

Comprobar su funcionamiento

Compruebe que el archivo se haya descargado correctamente:

sudo ls -lh /root/enable_relay_display.sh

Compruebe la sintaxis del script:

sudo bash -n /root/enable_relay_display.sh

Muestre la ayuda del script:

sudo /root/enable_relay_display.sh --help

Este comando muestra las diferentes funciones disponibles.

Nota:
El modo puntual no requiere ninguna instalación adicional.
El script se puede ejecutar directamente tras descargarlo y convertirlo en ejecutable.


3. ¿Cuáles son las posibilidades de uso?

El script ofrece tres modos principales.

Ejecución puntual

Permite hacer visibles inmediatamente los relays existentes.

sudo /root/enable_relay_display.sh run

Automatización con cron

Permite comprobar periódicamente la presencia de las reglas necesarias, especialmente cuando se añaden nuevos relays.

sudo /root/enable_relay_display.sh install-cron --interval 15

Automatización con MariaDB

Permite realizar las comprobaciones de forma automática desde el programador de eventos de MariaDB.

sudo /root/enable_relay_display.sh install-proc --interval 15

Recomendación:
Para una instalación estándar de Medulla, el modo install-cron con un intervalo de 15 minutos constituye una solución fácil de gestionar.


4. Utilizar el menú interactivo

El script dispone de un menú interactivo que permite acceder a las funciones principales sin necesidad de introducir los comandos manualmente.

Abrir el menú

sudo /root/enable_relay_display.sh menu

También es posible ejecutarlo directamente:

sudo /root/enable_relay_display.sh

El menú permite, entre otras cosas:

  • Realizar una corrección puntual.
  • Realizar una simulación.
  • Instalar una automatización cron.
  • Configurar una automatización de MariaDB.
  • Anular una operación anterior.
  • Reactivar una automatización suspendida.
  • Consultar el estado de los relays y las automatizaciones.

Nota:
El menú interactivo resulta especialmente adecuado para el primer uso del script.


5. Simular los cambios antes de aplicarlos

Antes de realizar modificaciones, se recomienda ejecutar una simulación.

Ejecutar una simulación

sudo /root/enable_relay_display.sh run --dry-run

Este comando permite:

  • Comprobar los requisitos previos.
  • Identificar los relays existentes.
  • Identificar los relays que requieren una regla global.
  • Consultar las operaciones que se llevarían a cabo.
  • Comprobar los registros generados.

Simulación:
El modo --dry-run permite preparar y visualizar las operaciones sin aplicar los cambios a las reglas de Medulla.

Simular una instalación de cron

sudo /root/enable_relay_display.sh install-cron --interval 15 --dry-run

Simular una instalación de MariaDB

sudo /root/enable_relay_display.sh install-proc --interval 15 --dry-run

6. Hacer visibles inmediatamente todos los relays

Para aplicar las reglas que faltan a los relays existentes, utilice el modo puntual.

Iniciar la ejecución

sudo /root/enable_relay_display.sh run

El script realiza automáticamente las siguientes operaciones:

  1. Comprobación del entorno.
  2. Búsqueda de los relays existentes.
  3. Identificación de los relays que requieren una regla global.
  4. Incorporación de las reglas que faltan.
  5. Registro del resultado de la ejecución.
  6. Creación de un archivo que permita deshacer los cambios.

Las reglas ya existentes no se vuelven a crear.

Comprobar el resultado

sudo /root/enable_relay_display.sh status

Éxito:
Cuando la ejecución finaliza correctamente y ningún relay requiere una nueva regla, las reglas globales buscadas están presentes para todos los relays existentes.


7. ¿Se puede ejecutar el script varias veces?

Sí.

El script puede ejecutarse varias veces sin volver a crear las reglas ya existentes.

Para volver a realizar una comprobación:

sudo /root/enable_relay_display.sh run

Si todos los relays ya disponen de las reglas necesarias, no se añade ninguna regla nueva.

Esta opción resulta especialmente útil tras añadir nuevos relays.


8. Automatizar la visibilidad de los relays con cron

El modo cron permite mantener automáticamente las reglas globales de los relays.

Se recomienda cuando puedan añadirse regularmente nuevos relays a la infraestructura de Medulla.

Configurar una automatización cada 15 minutos

sudo /root/enable_relay_display.sh install-cron --interval 15

El script instala una tarea programada en el servidor Debian.

Durante la instalación se lleva a cabo una primera ejecución para procesar los relays existentes.

Ubicación de la tarea cron

La tarea se instala en:

/etc/cron.d/medulla-relay-display

Comprobar si existe la tarea

sudo cat /etc/cron.d/medulla-relay-display

Comprobar el estado de la automatización

sudo /root/enable_relay_display.sh status

Nota:
Una vez instalada la automatización, los nuevos relays se procesan en la siguiente ejecución programada.
Normalmente, ya no es necesario volver a ejecutar el script manualmente.


9. ¿Qué intervalos se pueden utilizar con cron?

El modo cron admite los siguientes intervalos:

  • 1 minuto: --interval 1
  • 2 minutos: --interval 2
  • 3 minutos: --interval 3
  • 4 minutos: --interval 4
  • 5 minutos: --interval 5
  • 6 minutos: --interval 6
  • 10 minutos: --interval 10
  • 12 minutos: --interval 12
  • 15 minutos: --interval 15
  • 20 minutos: --interval 20
  • 30 minutos: --interval 30

El intervalo debe dividir exactamente 60 minutos.

Ejemplo: comprobación cada 5 minutos

sudo /root/enable_relay_display.sh install-cron --interval 5

Ejemplo: comprobación cada 30 minutos

sudo /root/enable_relay_display.sh install-cron --interval 30

Atención:
Un intervalo como --interval 7 no es válido para el modo cron.
Utilice uno de los valores permitidos.


10. Automatizar la visibilidad de los relays con MariaDB

El script ofrece un segundo método de automatización que utiliza directamente el programador de eventos de MariaDB.

Este método permite mantener las reglas globales sin necesidad de instalar una tarea cron en Debian.

Instalar la automatización de MariaDB

sudo /root/enable_relay_display.sh install-proc --interval 15

Este comando configura la automatización para que realice una comprobación cada 15 minutos.

Durante la instalación se lleva a cabo una primera ejecución.

Utilizar otro intervalo

Por ejemplo, para una comprobación cada 30 minutos:

sudo /root/enable_relay_display.sh install-proc --interval 30

Comprobar la instalación

sudo /root/enable_relay_display.sh status

Nota:
La automatización de MariaDB requiere que el programador de eventos del servidor esté activo.


11. Comprobar el programador de eventos de MariaDB

Para que la automatización de MariaDB funcione, el programador de eventos debe estar activado.

Comprobar su estado

sudo mysql -N -B -e "SELECT @@GLOBAL.event_scheduler;"

El resultado esperado es:

ON

Si el resultado es OFF, el programador no está activo.

Activar temporalmente el programador

Si es necesario, y tras comprobar la configuración del servidor:

sudo mysql -e "SET GLOBAL event_scheduler = ON;"

Es posible que este cambio no se mantenga tras reiniciar MariaDB.

Para una activación permanente, adapte la configuración de MariaDB del servidor.

Atención:
La activación del programador de MariaDB puede afectar a otros eventos presentes en el servidor.
Compruebe su uso antes de modificar este parámetro.


12. ¿Qué sistema de automatización elegir: cron o MariaDB?

Ambos métodos permiten mantener automáticamente las reglas globales de los relays.

Elegir cron si:

  • Desea una automatización gestionada desde Debian.
  • Ya utiliza cron para sus tareas del sistema.
  • Desea consultar fácilmente la tarea programada.
  • Prefiere una solución sencilla de supervisar.

Elegir MariaDB si:

  • Prefiere una automatización gestionada directamente por la base de datos.
  • Ya se utiliza el programador de eventos de MariaDB.
  • No desea añadir una tarea cron del sistema.

Recomendación:
Para una instalación estándar de Medulla, recomendamos el modo install-cron con una comprobación cada 15 minutos.


13. ¿Se pueden instalar ambas automatizaciones simultáneamente?

No.

El script está diseñado para utilizar un único método de automatización a la vez.

Debe elegir:

  • O bien la automatización cron.
  • O la automatización de MariaDB.

Para cambiar de método, desinstale primero la automatización existente utilizando su archivo de reversión.

A continuación, instale la nueva automatización.


14. Comprobar el estado de los relays y las automatizaciones

El script ofrece un comando que permite consultar el estado de la configuración.

Mostrar el estado

sudo /root/enable_relay_display.sh status

Este comando permite, entre otras cosas, comprobar:

  • La existencia de una automatización cron.
  • La existencia de una automatización de MariaDB.
  • El estado del programador de MariaDB.
  • Los relays que aún no disponen de la regla global.
  • La posible existencia de duplicados.
  • Los archivos de reversión disponibles.

Buena práctica:
Ejecute el comando status tras cada instalación, modificación o desinstalación.


15. ¿Qué ocurre cuando se añade un nuevo relay?

El comportamiento depende del modo utilizado.

En el modo puntual

El nuevo relay se tendrá en cuenta en la próxima ejecución manual.

sudo /root/enable_relay_display.sh run

Con una automatización

El nuevo relay se tendrá en cuenta automáticamente en la próxima ejecución programada.

Normalmente no es necesaria ninguna intervención manual.


16. Consultar los registros de ejecución

El script almacena la información relativa a sus ejecuciones en un directorio de registros.

Por defecto, cuando el script se coloca en /root/, este directorio es:

/root/relay_display_logs/

Visualizar los archivos disponibles

sudo ls -lah /root/relay_display_logs/

Consultar el registro de cron

sudo tail -n 100 /root/relay_display_logs/cron.log

Seguir las ejecuciones de cron en tiempo real

sudo tail -f /root/relay_display_logs/cron.log

Buscar los últimos registros

sudo find /root/relay_display_logs/ -type f -name "*.log" -printf "%T@ %p\n" | sort -nr | head -20

Nota:
La ubicación de los registros se puede personalizar mediante la variable LOG_DIR.


17. ¿Cómo se anula una ejecución puntual?

El script genera un archivo de reversión que permite anular los cambios realizados.

Buscar los archivos de reversión

sudo find /root/relay_display_logs/ -name "*.rollback.sh"

Ejecutar la reversión

sudo /root/enable_relay_display.sh rollback /root/relay_display_logs/NOMBRE.rollback.sh

Sustituya NOMBRE.rollback.sh por el nombre del archivo correspondiente a la ejecución que desea anular.

El script realiza las comprobaciones necesarias antes de eliminar las reglas en cuestión.

Atención:
Es importante utilizar el archivo de reversión correspondiente a la ejecución que desea anular.
No elimine manualmente las reglas en MariaDB.


18. ¿Cómo se desinstala la automatización de cron?

Para eliminar la automatización de cron, utilice el archivo de reversión creado durante su instalación.

Identificar el archivo de reversión

sudo find /root/relay_display_logs/ -name "*.rollback.sh"

Iniciar la desinstalación

sudo /root/enable_relay_display.sh rollback /root/relay_display_logs/NOMBRE.rollback.sh

El script le permite elegir entre dos opciones:

  • Conservar las reglas: eliminar la automatización sin eliminar las reglas ya añadidas.
  • Eliminar las reglas: eliminar la automatización y revertir los cambios realizados por esta, siempre que las reglas no se hayan modificado desde entonces.

Comprobar la desinstalación

sudo /root/enable_relay_display.sh status

La tarea cron correspondiente a esta instalación ya no debe estar activa.


19. ¿Cómo se desinstala la automatización de MariaDB?

La desinstalación de la automatización de MariaDB también utiliza el archivo de reversión creado durante su instalación.

Identificar el archivo de reversión

sudo find /root/relay_display_logs/ -name "*.rollback.sh"

Iniciar la desinstalación

sudo /root/enable_relay_display.sh rollback /root/relay_display_logs/NOMBRE.rollback.sh

El script le ofrece la opción de conservar o eliminar las reglas añadidas por la automatización.

A continuación, procede a desinstalar los componentes de MariaDB correspondientes.

Comprobar la desinstalación

sudo /root/enable_relay_display.sh status

Nota:
La reversión comprueba la identidad de la instalación antes de eliminar los componentes asociados.
Esto evita que un archivo de reversión anterior elimine una instalación más reciente.


20. ¿Qué ocurre si se han modificado algunas reglas?

Una regla añadida por el script puede ser modificada posteriormente por un administrador o por otro componente.

En ese caso, la reversión normal protege las reglas modificadas para evitar su eliminación involuntaria.

Si se detectan modificaciones, el script puede negarse a continuar con la eliminación de determinadas reglas.

En ese caso, se recomienda:

  1. Consultar el mensaje que muestra el script.
  2. Identificar las reglas afectadas.
  3. Comprobar si es necesario conservar dichas modificaciones.
  4. Reanudar la reversión según el resultado deseado.

Atención:
No elimine manualmente una regla modificada sin haber comprobado su uso actual en Medulla.


21. ¿Cómo se realiza una reversión parcial?

Cuando se han modificado algunas reglas, el script permite continuar con la reversión conservando dichas reglas.

Las reglas que no se hayan modificado pueden eliminarse.

Las reglas modificadas permanecen activas.

El archivo de reversión se conserva por si fuera necesaria una intervención adicional.

Nota:
Una reversión parcial no significa necesariamente que la operación haya fallado.
Puede indicar simplemente que se han conservado determinadas reglas para evitar la pérdida de modificaciones posteriores.


22. ¿Cómo se reanuda una reversión interrumpida?

Si se interrumpe una reversión, es posible reiniciarla con el mismo archivo.

Reiniciar la reversión

sudo /root/enable_relay_display.sh rollback /root/relay_display_logs/NOMBRE.rollback.sh

El script tiene en cuenta los pasos ya realizados e intenta continuar con la operación.

Atención:
No elimine los archivos de reversión ni los archivos de estado hasta que la operación haya finalizado.


23. ¿Cómo se reactiva una automatización suspendida?

Una automatización puede quedar suspendida como consecuencia de una reversión interrumpida.

Cuando su estado lo permita, es posible reactivarla.

Reactivar la automatización

sudo /root/enable_relay_display.sh reactivate

Comprobar su estado

sudo /root/enable_relay_display.sh status

Atención:
La reactivación se rechaza cuando la reversión ya ha comenzado a eliminar las reglas.
En esta situación, debe continuar o finalizar la reversión.


24. ¿Cómo se cambia el idioma del script?

El script está disponible en tres idiomas:

  • Francés.
  • Inglés.
  • Español.

Utilizar el francés

sudo /root/enable_relay_display.sh status --lang fr

Utilizar el inglés

sudo /root/enable_relay_display.sh status --lang en

Utilizar el español

sudo /root/enable_relay_display.sh status --lang es

El parámetro --lang también se puede utilizar con los demás comandos.

Ejemplo:

sudo /root/enable_relay_display.sh run --dry-run --lang en

25. ¿Qué debe hacer si el script muestra un error?

En caso de error, comience por consultar el mensaje que aparece en el terminal.

Entre las posibles causas se incluyen, entre otras:

  • Permisos insuficientes.
  • Una conexión a MariaDB no disponible.
  • Una configuración de la base de datos incompatible.
  • Una automatización ya instalada.
  • Un intervalo de programación incorrecto.
  • Una operación anterior incompleta.
  • Hay otra ejecución en curso.

Realizar un primer diagnóstico

sudo /root/enable_relay_display.sh status

Consultar los registros

sudo ls -lah /root/relay_display_logs/

A continuación, examine el registro correspondiente a la operación que ha fallado.

Nota:
Si el script rechaza una operación, no eluda las comprobaciones de seguridad sin haber identificado la causa del rechazo.


26. ¿Por qué un relay sigue sin ser visible tras la ejecución?

El script añade las reglas globales necesarias para que los relays sean visibles.

No modifica el resto de parámetros de funcionamiento de Medulla.

Si un relay sigue sin ser visible:

  1. Comprobar que el script haya finalizado sin errores.
  2. Ejecutar el comando status.
  3. Actualizar la interfaz de Medulla.
  4. Comprobar los derechos del usuario en cuestión.
  5. Comprobar la configuración del relay.
  6. Consultar los registros de Medulla si el problema persiste.

Comprobar el estado

sudo /root/enable_relay_display.sh status

27. ¿Se puede mover o eliminar el script tras su instalación?

Se recomienda mantener el script en su ubicación original mientras haya una automatización activa.

En concreto, el modo cron utiliza la ruta del script registrada durante la instalación.

Si se mueve o se elimina el archivo, es posible que las próximas ejecuciones automáticas fallen.

Conserve también los archivos de reversión hasta que haya desinstalado completamente la automatización.

Atención:
No elimine el script ni su directorio de registros antes de haber desinstalado las automatizaciones y comprobado su estado.


28. ¿Qué procedimiento debe seguir para el primer uso?

Para el primer uso en un servidor Medulla, recomendamos el siguiente procedimiento.

Paso 1: descargar el script

sudo wget -O /root/enable_relay_display.sh https://dl.medulla-tech.io/ma/enable_relay_display.sh
sudo chmod 700 /root/enable_relay_display.sh

Paso 2: comprobar el entorno

sudo /root/enable_relay_display.sh status

Paso 3: realizar una simulación

sudo /root/enable_relay_display.sh run --dry-run

Paso 4: aplicar las reglas que faltan

sudo /root/enable_relay_display.sh run

Paso 5: comprobar el resultado

sudo /root/enable_relay_display.sh status

Paso 6: comprobar la visibilidad en Medulla

Inicie sesión en la interfaz de Medulla y compruebe que los relays esperados sean visibles para los usuarios correspondientes.

Paso 7: configurar una automatización si es necesario

Para una automatización cada 15 minutos:

sudo /root/enable_relay_display.sh install-cron --interval 15

Paso 8: comprobar la configuración

sudo /root/enable_relay_display.sh status

Éxito:
Cuando las comprobaciones sean satisfactorias y la automatización esté activa, los nuevos relays se tendrán en cuenta automáticamente en las próximas ejecuciones.


29. Resumen de los comandos

Descargar el script

sudo wget -O /root/enable_relay_display.sh https://dl.medulla-tech.io/ma/enable_relay_display.sh

Hacer que el script sea ejecutable

sudo chmod 700 /root/enable_relay_display.sh

Ver la ayuda

sudo /root/enable_relay_display.sh --help

Abrir el menú interactivo

sudo /root/enable_relay_display.sh menu

Consultar el estado

sudo /root/enable_relay_display.sh status

Simular una ejecución

sudo /root/enable_relay_display.sh run --dry-run

Ejecutar una corrección puntual

sudo /root/enable_relay_display.sh run

Instalar una automatización cron

sudo /root/enable_relay_display.sh install-cron --interval 15

Configurar una automatización de MariaDB

sudo /root/enable_relay_display.sh install-proc --interval 15

Anular una operación

sudo /root/enable_relay_display.sh rollback /root/relay_display_logs/NOMBRE.rollback.sh

Reactivar una automatización suspendida

sudo /root/enable_relay_display.sh reactivate

Mostrar los mensajes en inglés

sudo /root/enable_relay_display.sh status --lang en

Consultar los registros

sudo ls -lah /root/relay_display_logs/
sudo tail -n 100 /root/relay_display_logs/cron.log

30. Recomendaciones

Para utilizar el script en las mejores condiciones:

  • Realizar una copia de seguridad antes de utilizarlo por primera vez.
  • Utilizar una cuenta con permisos de sudo.
  • Comenzar con una simulación utilizando la opción --dry-run.
  • Comprobar el resultado en la interfaz de Medulla.
  • Optar por el modo cron para una automatización sencilla.
  • No instalar ambas automatizaciones simultáneamente.
  • Conservar los archivos de reversión.
  • No mover el script cuando una automatización lo esté utilizando.
  • Consultar los registros en caso de error.
  • Comprobar periódicamente el estado con el comando status.

En resumen:
Para que todos los relays sean visibles de forma inmediata, utilice sudo /root/enable_relay_display.sh run.
Para mantener su visibilidad de forma automática, utilice install-cron o install-proc con sudo.
Para comprobar la configuración, utilice sudo /root/enable_relay_display.sh status.
Para anular una operación, utilice el archivo de reversión correspondiente.