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
- 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.
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:
- Comprobación del entorno.
- Búsqueda de los relays existentes.
- Identificación de los relays que requieren una regla global.
- Incorporación de las reglas que faltan.
- Registro del resultado de la ejecución.
- 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:
- Consultar el mensaje que muestra el script.
- Identificar las reglas afectadas.
- Comprobar si es necesario conservar dichas modificaciones.
- 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:
- Comprobar que el script haya finalizado sin errores.
- Ejecutar el comando
status. - Actualizar la interfaz de Medulla.
- Comprobar los derechos del usuario en cuestión.
- Comprobar la configuración del relay.
- 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.