Relais – Rendre les relais visibles pour tous les utilisateurs

Version : Medulla 5.6.x
Environnement : On-Premise / Debian 12 / MariaDB
Catégorie : Administration / Gestion des relais
Script : enable_relay_display.sh

1. À quoi sert ce script ?

Dans Medulla, les relais permettent notamment de distribuer les logiciels, d'exécuter certaines opérations et de gérer les postes de travail depuis différents points du réseau.

Selon la configuration, un relais peut ne pas être visible par tous les utilisateurs.

Le script enable_relay_display.sh permet de créer les règles globales nécessaires pour rendre les relais disponibles à tous les utilisateurs.

Il peut fonctionner de trois façons :

Exécution ponctuelle : corriger immédiatement les relais existants.
Automatisation cron : vérifier régulièrement les relais depuis Debian.
Automatisation MariaDB : effectuer cette vérification automatiquement depuis la base de données.

Bon à savoir :
Le script ne modifie pas les relais eux-mêmes. Il ajoute uniquement les règles manquantes. Les règles déjà présentes sont conservées.

2. Quels sont les prérequis ?

Avant d'utiliser le script, vérifier les points suivants :

Disposer d'un serveur Medulla On-Premise.
Utiliser un environnement Debian compatible, notamment Debian 12.
Disposer d'un serveur MariaDB compatible.
Avoir accès aux bases de données Medulla.
Disposer des droits nécessaires pour exécuter les commandes.
Utiliser un compte administrateur pour installer une automatisation système.

Le script vérifie automatiquement plusieurs prérequis avant toute modification.

Recommandation :
Avant une première utilisation sur un serveur de production, effectuer une sauvegarde des bases Medulla.

3. Comment installer le script ?

Télécharger le script enable_relay_display.sh et le copier sur le serveur Medulla.

Dans les exemples suivants, nous utiliserons le répertoire :

/root/

Rendre le script exécutable :

sudo chmod 700 /root/enable_relay_display.sh

Afficher l'aide :

sudo /root/enable_relay_display.sh --help

Il n'est pas nécessaire de procéder à une installation particulière pour utiliser le mode ponctuel.

4. Comment utiliser le menu interactif ?

Le script dispose d'un menu interactif permettant d'accéder aux principales fonctions sans mémoriser les commandes.

sudo /root/enable_relay_display.sh menu

Il est également possible de lancer le script sans argument :

sudo /root/enable_relay_display.sh

Lancer une exécution ponctuelle.
Effectuer une simulation.
Installer une automatisation cron.
Installer une automatisation MariaDB.
Annuler une opération précédente.
Réactiver une automatisation suspendue.
Consulter l'état du système.

Conseil :
Pour une première utilisation, le menu interactif est recommandé. Il permet de découvrir les différentes possibilités du script.

5. Comment vérifier ce que le script va modifier ?

Avant toute modification, il est recommandé d'effectuer une simulation.

Commande :

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

Cette commande permet de :

Vérifier l'environnement.
Identifier les relais concernés.
Visualiser les opérations prévues.
Consulter les journaux générés.

Aucune règle n'est ajoutée ou supprimée pendant la simulation.

Cette commande peut être utilisée autant de fois que nécessaire.

6. Comment rendre immédiatement tous les relais visibles ?

Pour ajouter les règles manquantes sur les relais existants, utiliser le mode ponctuel :

sudo /root/enable_relay_display.sh run

Le script effectue automatiquement les opérations suivantes :

Vérifie les prérequis.
Recherche les relais existants.
Identifie les relais ne disposant pas de la règle globale.
Ajoute les règles nécessaires.
Enregistre le résultat de l'opération.
Génère un fichier permettant d'annuler les modifications.

Une fois l'exécution terminée, les règles globales nécessaires sont présentes pour les relais traités.

Attention :
Le mode ponctuel traite les relais présents au moment de son exécution. Si de nouveaux relais sont ajoutés ultérieurement, il faudra relancer le script ou utiliser une automatisation.

7. Peut-on exécuter plusieurs fois le script ?

Oui.

Le script peut être exécuté plusieurs fois. Il vérifie les règles existantes et n'ajoute que celles qui manquent.

Pour effectuer une nouvelle vérification :

sudo /root/enable_relay_display.sh run

Si aucun relais ne nécessite de modification, aucune nouvelle règle n'est créée.

8. Comment automatiser la visibilité des nouveaux relais avec cron ?

Le mode cron permet de vérifier automatiquement et régulièrement que tous les relais disposent de la règle globale.

Cette solution est particulièrement adaptée aux environnements dans lesquels des relais peuvent être ajoutés après l'installation initiale.

Pour installer une vérification toutes les 15 minutes :

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

Le script installe automatiquement la tâche planifiée.

Il effectue également un premier passage afin de traiter immédiatement les relais existants.

Quels intervalles peut-on utiliser ?

Les intervalles acceptés pour cron sont :

Intervalle	Fréquence
1	Toutes les minutes
2	Toutes les 2 minutes
3	Toutes les 3 minutes
4	Toutes les 4 minutes
5	Toutes les 5 minutes
6	Toutes les 6 minutes
10	Toutes les 10 minutes
12	Toutes les 12 minutes
15	Toutes les 15 minutes
20	Toutes les 20 minutes
30	Toutes les 30 minutes

Fréquence par défaut : 15 minutes.

Une fréquence de 15 minutes constitue généralement un bon compromis pour maintenir la visibilité des nouveaux relais.

9. Peut-on simuler l'installation cron ?

Oui.

Commande :

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

Cette commande permet de vérifier les opérations prévues sans installer la tâche planifiée.

10. Comment automatiser directement avec MariaDB ?

Le script propose également une automatisation utilisant le planificateur d'événements MariaDB.

Cette méthode évite d'utiliser une tâche cron système.

Pour installer une vérification toutes les 15 minutes :

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

Le script installe les éléments nécessaires dans MariaDB et effectue un premier passage.

Les vérifications suivantes sont réalisées automatiquement selon la fréquence configurée, lorsque le planificateur MariaDB est actif.

Comment simuler cette installation ?

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

11. Comment vérifier que l'automatisation MariaDB fonctionne ?

Le planificateur d'événements MariaDB doit être activé.

Pour vérifier son état :

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

Résultat attendu :

ON

Si le résultat est OFF, le planificateur n'est pas actif.

Il faudra vérifier la configuration MariaDB avant de compter sur l'exécution automatique des vérifications.

12. Faut-il choisir cron ou MariaDB ?

Les deux méthodes permettent d'obtenir le même résultat : maintenir les règles globales des relais à jour.

Mode	Utilisation recommandée
run	Correction ponctuelle, sans automatisation.
install-cron	Automatisation simple, administrée depuis Debian.
install-proc	Automatisation directement gérée par MariaDB.

Notre recommandation :
Pour une installation Medulla classique, privilégier le mode cron avec un intervalle de 15 minutes.

13. Peut-on activer les deux automatisations simultanément ?

Non.

Il faut choisir une seule méthode d'automatisation : cron ou MariaDB.

Si une automatisation est déjà installée, il faut la désinstaller avant de passer à l'autre méthode.

14. Comment vérifier l'état du script et des automatisations ?

Utiliser la commande :

sudo /root/enable_relay_display.sh status

Cette commande permet de consulter notamment :

L'existence d'une automatisation cron.
La présence d'une automatisation MariaDB.
L'état du planificateur MariaDB.
Les relais qui nécessitent encore une règle globale.
Les éventuels doublons.
Les fichiers de rollback disponibles.

Il est recommandé d'utiliser cette commande après une installation ou une modification.

15. Que se passe-t-il lorsqu'un nouveau relais est ajouté ?

Le comportement dépend du mode choisi.

Mode ponctuel

Le nouveau relais ne sera traité qu'à la prochaine exécution manuelle.

sudo /root/enable_relay_display.sh run

Mode automatisé

Le nouveau relais sera pris en compte lors du prochain passage de l'automatisation.

Aucune intervention manuelle n'est normalement nécessaire.

16. Où consulter les résultats des exécutions ?

Le script conserve les journaux de ses opérations.

Par défaut, ils se trouvent dans le répertoire :

/root/relay_display_logs/

Pour afficher les fichiers :

sudo ls -lah /root/relay_display_logs/

Pour consulter le journal des exécutions cron :

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

Pour suivre les nouvelles lignes en temps réel :

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

Les journaux permettent de vérifier les opérations effectuées et d'identifier les éventuelles erreurs.

17. Comment annuler une exécution du script ?

Chaque exécution génère un fichier de rollback permettant d'annuler les modifications réalisées.

Ce fichier se trouve dans le répertoire des journaux.

Pour retrouver les fichiers disponibles :

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

Pour annuler une exécution, utiliser le fichier correspondant :

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

Remplacer NOM.rollback.sh par le nom réel du fichier.

Le script explique les opérations prévues et demande confirmation avant de poursuivre.

Important :
Utiliser le fichier de rollback correspondant à l'opération que vous souhaitez annuler. Ne pas supprimer manuellement les règles dans MariaDB.

18. Comment désinstaller l'automatisation cron ?

Utiliser le fichier de rollback généré lors de l'installation cron.

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

Deux possibilités sont proposées :

Conserver les règles : supprimer uniquement l'automatisation.
Supprimer les règles ajoutées : revenir autant que possible à la situation antérieure à l'installation.

La tâche cron correspondant à l'installation est ensuite supprimée lorsque les conditions du rollback sont réunies.

19. Comment désinstaller l'automatisation MariaDB ?

La désinstallation utilise également le fichier de rollback créé pendant l'installation.

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

Le script propose de conserver ou de retirer les règles ajoutées par cette automatisation.

Il désinstalle ensuite les composants MariaDB associés, lorsque les vérifications nécessaires sont satisfaites.

20. Que se passe-t-il si certaines règles ont été modifiées depuis leur création ?

Le script protège les règles ayant été modifiées après leur création.

Si une modification est détectée, le rollback normal peut être interrompu afin d'éviter une suppression involontaire.

Il est alors possible d'examiner les règles concernées et de décider de la suite à donner.

Le script propose également un mode permettant de supprimer uniquement les règles qui n'ont pas été modifiées.

Les règles modifiées restent conservées.

21. Comment reprendre un rollback interrompu ?

Si un rollback est interrompu, il est possible de relancer la même commande avec le même fichier.

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

Le script reprend les opérations en tenant compte des étapes déjà effectuées.

Attention :
Ne pas supprimer les fichiers de rollback ou d'état tant que l'opération n'est pas terminée.

22. Comment réactiver une automatisation suspendue ?

Une automatisation peut être suspendue à la suite d'un rollback interrompu.

Pour tenter de la réactiver :

sudo /root/enable_relay_display.sh reactivate

La réactivation n'est possible que si l'état de l'installation le permet.

Si le rollback a déjà commencé à supprimer des règles, la réactivation est refusée.

23. Comment changer la langue du script ?

Le script est disponible en trois langues :

Français.
Anglais.
Espagnol.

Pour afficher les messages en français :

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

Pour l'anglais :

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

Pour l'espagnol :

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

24. Que faire si le script affiche une erreur ?

Commencer par consulter le message affiché dans le terminal.

Les causes les plus fréquentes sont :

Permissions insuffisantes.
Connexion MariaDB impossible.
Structure de base de données incompatible.
Automatisation déjà installée.
Intervalle de planification incorrect.
Opération précédente incomplète.

Pour effectuer un premier diagnostic :

sudo /root/enable_relay_display.sh status

Consulter ensuite les journaux dans le répertoire relay_display_logs.

25. Pourquoi l'intervalle cron est-il refusé ?

Le mode cron accepte uniquement les intervalles qui divisent exactement 60 minutes.

Par exemple :

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

Cette commande est refusée.

Utiliser par exemple :

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

Ou :

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

26. Pourquoi un relais reste-t-il invisible après l'exécution ?

Le script ajoute les règles globales nécessaires à la visibilité des relais.

Il ne modifie pas les autres paramètres de configuration de Medulla.

Si un relais reste invisible :

Vérifier que l'exécution s'est terminée sans erreur.
Exécuter la commande status.
Actualiser l'interface Medulla.
Vérifier les droits de l'utilisateur concerné.
Contrôler la configuration du relais.

Si le problème persiste, consulter les journaux Medulla et ceux du script.

27. Peut-on déplacer ou supprimer le script après installation ?

Il est déconseillé de déplacer ou supprimer le script tant qu'une automatisation est active.

En particulier, une tâche cron peut utiliser le chemin du script enregistré lors de son installation.

Si ce fichier est déplacé ou supprimé, les prochaines exécutions risquent d'échouer.

Conserver également les fichiers de rollback jusqu'à la désinstallation complète de l'automatisation.

28. Quelles sont les bonnes pratiques recommandées ?

Conserver une sauvegarde avant la première exécution.
Commencer par une simulation.
Tester le mode ponctuel avant d'installer une automatisation.
Conserver les fichiers de rollback.
Vérifier régulièrement les journaux.
Ne pas installer deux automatisations simultanément.
Ne pas déplacer le script lorsqu'une tâche cron l'utilise.
Contrôler le résultat avec la commande status.

29. Quelle procédure suivre pour une première installation ?

Pour une première utilisation sur un serveur Medulla, nous recommandons la procédure suivante.

Étape 1 — Vérifier l'environnement

sudo /root/enable_relay_display.sh status

Étape 2 — Effectuer une simulation

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

Étape 3 — Appliquer les règles

sudo /root/enable_relay_display.sh run

Étape 4 — Vérifier le résultat

sudo /root/enable_relay_display.sh status

Étape 5 — Installer l'automatisation

Si les résultats sont conformes aux attentes :

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

Étape 6 — Contrôler l'installation

sudo /root/enable_relay_display.sh status

La configuration est alors en place.

30. Récapitulatif des commandes

Action	Commande
Afficher l'aide	`--help`
Ouvrir le menu	`menu`
Vérifier l'état	`status`
Simuler	`run --dry-run`
Exécuter une fois	`run`
Installer cron	`install-cron --interval 15`
Installer MariaDB	`install-proc --interval 15`
Annuler une opération	`rollback FICHIER.rollback.sh`
Réactiver	`reactivate`

Les commandes ci-dessus doivent être précédées du chemin du script.

Exemple :

sudo /root/enable_relay_display.sh status

En résumé

Le script enable_relay_display.sh simplifie la gestion de la visibilité des relais Medulla.

Pour une correction ponctuelle, utiliser run.

Pour maintenir automatiquement la visibilité des nouveaux relais, utiliser install-cron ou install-proc.

En cas de besoin, les fichiers de rollback permettent de revenir sur les opérations réalisées.