Relais – Rendre les relais visibles pour tous les utilisateurs

S'applique

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.

SelonCette laFAQ configuration,explique uncomment relaisutiliser peut ne pas être visible par tous les utilisateurs.

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

IlElle peutprésente fonctionnerles différentes possibilités d'utilisation du script : exécution ponctuelle, automatisation, simulation, consultation de troisl'état, façonsannulation :des modifications et réactivation.

2.1. Quels sont les prérequis ?Prérequis

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

Le script vérifieeffectue automatiquement plusieurs prérequisvérifications avant toutede modification.modifier la configuration.

3.2. CommentInstaller installerle script

Copier le script ?sur le serveur Medulla

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

Dans les exemples suivants,de nouscette utiliseronsFAQ, le script est placé dans le répertoire :

/root/enable_relay_display.sh

Rendre le script exécutable :

sudo chmod 700 /root/enable_relay_display.sh

Vérifier son fonctionnement

Afficher l'aide du script :

sudo /root/enable_relay_display.sh --help

IlCette n'estcommande pasprésente nécessaireles différentes fonctions disponibles.

Information :
Le mode ponctuel ne nécessite aucune installation supplémentaire.
Le script peut être exécuté directement après avoir été copié sur le serveur.

3. Quelles sont les possibilités d'utilisation ?

Le script propose trois modes principaux.

Exécution ponctuelle

Permet de procéderrendre àimmédiatement visibles les relais existants.

/root/enable_relay_display.sh run

Automatisation avec cron

Permet de vérifier régulièrement la présence des règles nécessaires, notamment lorsque de nouveaux relais sont ajoutés.

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

Automatisation avec MariaDB

Permet d'effectuer les vérifications automatiquement depuis le planificateur d'événements MariaDB.

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

Recommandation :
Pour une installation particulièreMedulla pour utiliserclassique, le mode ponctuel.install-cron avec un intervalle de 15 minutes constitue une solution simple à administrer.

4. Comment utiliserUtiliser le menu interactif ?

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

Pour ouvrir

Ouvrir le menu :

sudo /root/enable_relay_display.sh menu

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

sudo /root/enable_relay_display.sh

Le menu permet notamment de :

5. CommentSimuler vérifierles cemodifications queavant leleur script va modifier ?application

Avant touted'effectuer modification,des modifications, il est recommandé d'effectuerde lancer une simulation.

Commande

Exécuter :une simulation

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

Cette commande permet de :

AucuneSimulation règle:
Le n'estmode ajoutée--dry-run ou supprimée pendant la simulation.

Cette commande peut être utilisée autantpermet de foispréparer queet nécessaire.de visualiser les opérations sans appliquer les modifications sur les règles Medulla.

Simuler une installation cron

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

Simuler une installation MariaDB

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

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

Pour ajouterappliquer les règles manquantes sur les relais existants, utiliser le mode ponctuelponctuel.

Lancer l'exécution

sudo /root/enable_relay_display.sh run

Le script effectue automatiquement les opérations suivantes :

Les règles déjà existantes ne sont pas recréées.

Vérifier le résultat

/root/enable_relay_display.sh status

UneSuccès fois:
Lorsque l'exécution terminée,se termine correctement et qu'aucun relais ne nécessite de nouvelle règle, les règles globales nécessairesrecherchées sont présentes pour les relais traités.

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

Oui.

Le script peut être exécuté plusieurs fois.fois Ilsans vérifierecréer les règles existantesdéjà et n'ajoute que celles qui manquent.présentes.

Pour effectuerrelancer une nouvelle vérification :

sudo /root/enable_relay_display.sh run

Si aucuntous les relais nedisposent nécessitedéjà dedes modification,règles nécessaires, aucune nouvelle règle n'est créée.ajoutée.

Cette possibilité est particulièrement utile après l'ajout de nouveaux relais.

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

Le mode cron permet de vérifiermaintenir automatiquement et régulièrement que tous les relaisrègles disposentglobales des relais.

Il est recommandé lorsque de la règle globale.

Cette solution est particulièrement adaptée aux environnements dans lesquels desnouveaux relais peuvent être ajoutés aprèsrégulièrement à l'installationinfrastructure initiale.Medulla.

Pour installer

Installer une vérificationautomatisation toutes les 15 minutes :

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

Le script installe automatiquement laune tâche planifiée.planifiée sur le serveur Debian.

Il effectue également unUn premier passage est effectué lors de l'installation afin de traiter immédiatement les relais existants.

Emplacement de la tâche cron

La tâche est installée dans :

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

Vérifier la présence de la tâche

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

Vérifier l'état de l'automatisation

/root/enable_relay_display.sh status

Information :
Une fois l'automatisation installée, les nouveaux relais sont traités lors du prochain passage planifié.
Il n'est normalement plus nécessaire de relancer manuellement le script.

9. Quels intervalles peut-on utiliser ?

Les intervalles acceptés pour cron sont :

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'installationavec cron ?

Oui.

Commandemode cron accepte les intervalles suivants :

L'intervalle doit diviser exactement 60 minutes.

Exemple : vérification toutes les 5 minutes

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

Exemple : vérification toutes les 30 minutes

/root/enable_relay_display.sh install-cron --dry-runinterval 30

CetteAttention commande:
Un permetintervalle decomme vérifier--interval les7 opérationsest prévuesrefusé sanspour installerle lamode tâchecron.
Utiliser planifiée.l'une des valeurs autorisées.

10. CommentAutomatiser automatiserla directementvisibilité des relais avec MariaDB ?

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

Cette méthode évitepermet d'utiliserde unemaintenir les règles globales sans installer de tâche cron système.sur Debian.

Pour

Installer installerl'automatisation une vérification toutes les 15 minutes :MariaDB

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

LeCette scriptcommande installeconfigure l'automatisation pour une vérification toutes les éléments15 nécessairesminutes.

Un MariaDBpremier etpassage effectueest effectué pendant l'installation.

Utiliser un premierautre passage.intervalle

LesPar vérificationsexemple, suivantespour sontune réaliséesvérification automatiquementtoutes selonles la30 fréquenceminutes configurée, lorsque le planificateur MariaDB est actif.:

Comment simuler cette installation ?

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

Vérifier l'installation

/root/enable_relay_display.sh status

Information :
L'automatisation MariaDB nécessite que le planificateur d'événements du serveur soit actif.

11. CommentVérifier vérifierle planificateur MariaDB

Pour que l'automatisation MariaDB fonctionnefonctionne, ?

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

Pour vérifier

Contrôler son état :

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

RésultatLe résultat attendu est :

ON

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

Activer temporairement le planificateur

IlSi faudranécessaire, vérifieret après vérification de la configuration du serveur :

mysql -e "SET GLOBAL event_scheduler = ON;"

Cette modification peut ne pas être conservée après un redémarrage de MariaDB.

Pour une activation permanente, adapter la configuration MariaDB du serveur.

Attention :
L'activation du planificateur MariaDB peut concerner d'autres événements présents sur le serveur.
Vérifier son utilisation avant de comptermodifier surce l'exécution automatique des vérifications.paramètre.

12. Faut-ilQuelle automatisation choisir : cron ou MariaDB ?

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

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

Non.

IlLe fautscript choisirest conçu pour utiliser une seule méthode d'automatisation :à cronla ou MariaDB.fois.

Si une automatisation est déjà installée, ilIl faut lachoisir :

Pour changer de méthode, désinstaller avantd'abord del'automatisation passerexistante à l'autreaide méthode.de son fichier de rollback.

Installer ensuite la nouvelle automatisation.

14. Comment vérifierVérifier l'état dudes scriptrelais et des automatisations ?

UtiliserLe script propose une commande permettant de consulter l'état de la commandeconfiguration.

Afficher l'état

sudo /root/enable_relay_display.sh status

Cette commande permet notamment de consulter notammentvérifier :

Bonne

Ilpratique est:

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

Le comportement dépend du mode choisi.utilisé.

ModeAvec le 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 de la prochaine exécution manuelle.

/root/enable_relay_display.sh run

Avec une automatisation

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

Aucune intervention manuelle n'est normalement nécessaire.

16. Où consulterConsulter les résultatsjournaux des exécutions ?d'exécution

Le script conserve les journauxinformations relatives à ses exécutions dans un répertoire de ses opérations.journaux.

Par défaut, ilslorsque sele trouventscript est placé dans le/root/, ce répertoire est :

/root/relay_display_logs/

Pour afficher

Afficher les fichiers :disponibles

sudo ls -lah /root/relay_display_logs/

Pour consulter

Consulter le journal des exécutions cron :

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

Pour suivre

Suivre les nouvellesexécutions lignescron en temps réel :

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

Rechercher les derniers journaux

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

LesInformation :
L'emplacement des journaux permettentpeut deêtre vérifierpersonnalisé lesavec opérationsla effectuéesvariable et d'identifier les éventuelles erreurs.LOG_DIR.

17. Comment annuler une exécution du scriptponctuelle ?

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

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

Pour retrouver

Rechercher les fichiers disponiblesde :rollback

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

Pour annuler une exécution, utiliser

Exécuter le fichier correspondant :rollback

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.fichier correspondant à l'exécution à annuler.

Le script expliqueeffectue les opérationsvérifications prévues et demande confirmationnécessaires avant de poursuivre.supprimer les règles concernées.

18. Comment désinstaller l'automatisation cron ?

UtiliserPour supprimer l'automatisation cron, utiliser le fichier de rollback générécréé lors de l'installationson cron.installation.

Identifier le fichier de rollback

sudofind /root/relay_display_logs/ -name "*.rollback.sh"

Lancer la désinstallation

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

DeuxLe script permet de choisir entre deux possibilités sont proposées :

Vérifier la désinstallation

/root/enable_relay_display.sh status

La tâche cron correspondant à l'cette installation estne ensuitedoit suppriméeplus lorsqueêtre les conditions du rollback sont réunies.active.

19. Comment désinstaller l'automatisation MariaDB ?

La désinstallation de l'automatisation MariaDB utilise également le fichier de rollback créé pendantlors l'de son installation.

Identifier le fichier de rollback

sudofind /root/relay_display_logs/ -name "*.rollback.sh"

Lancer la désinstallation

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

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

Il désinstalleprocède ensuite à la désinstallation des composants MariaDB concernés.

Vérifier la désinstallation

/root/enable_relay_display.sh status

Information :
Le rollback vérifie l'identité de l'installation avant de supprimer les composants MariaDBassociés.
Cela associés,permet lorsqued'éviter lesqu'un vérificationsancien nécessairesfichier sontde satisfaites.rollback supprime une installation plus récente.

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

LeUne règle ajoutée par le script peut être modifiée ultérieurement par un administrateur ou par un autre composant.

Dans ce cas, le rollback normal 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 uneleur suppression involontaire.

Si des modifications sont détectées, le script peut refuser de poursuivre la suppression de certaines règles.

Il est alors possiblerecommandé d'examinerde :

Attention :
Ne pas supprimer manuellement une règle modifiée sans avoir vérifié son utilisation actuelle dans Medulla.

21. Comment effectuer un rollback partiel ?

Lorsque certaines règles ont été modifiées, le script permet de déciderpoursuivre dele larollback suiteen àconservant donner.ces règles.

Le script propose également un mode permettant de supprimer uniquement lesLes règles qui n'ont pas été modifiées.modifiées peuvent être supprimées.

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

Le fichier de rollback est conservé lorsqu'une intervention complémentaire reste nécessaire.

Information :
Un rollback partiel ne signifie pas nécessairement que l'opération a échoué.
Il peut simplement indiquer que certaines règles ont été conservées pour éviter la perte de modifications ultérieures.

21.22. Comment reprendre un rollback interrompu ?

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

Relancer le rollback

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

Le script reprend les opérationsprend en tenant compte desles étapes déjà effectuées.effectuées et tente de poursuivre l'opération.

22.23. Comment réactiver une automatisation suspendue ?

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

PourLorsque tenterson état le permet, il est possible de la réactiverréactiver.

Réactiver l'automatisation

sudo /root/enable_relay_display.sh reactivate

Vérifier son état

/root/enable_relay_display.sh status

Attention :
La réactivation n'est possiblerefusée que si l'état de l'installation le permet.

Silorsque le rollback a déjà commencé à supprimer desles règles,règles.
Dans lacette réactivationsituation, estil refusée.faut poursuivre ou terminer le rollback.

23.24. Comment changer la langue du script ?

Le script est disponible en trois langues :

Utiliser

Pour afficher les messages enle français :

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

Pour

Utiliser l'anglais :

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

Pour

Utiliser l'espagnol :

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

Le paramètre --lang peut également être utilisé avec les autres commandes.

Exemple :

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

24.25. Que faire si le script affiche une erreur ?

CommencerEn cas d'erreur, commencer par consulter le message affiché dans le terminal.

Les causes lespossibles pluscomprennent fréquentes sontnotamment :

Pour effectuer

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 :

sudols -lah /root/enable_relay_display.sh install-cron --interval 7relay_display_logs/

CetteExaminer commandeensuite estle refusée.journal correspondant à l'opération ayant échoué.

Utiliser par exempleInformation :
Si le script refuse une opération, ne pas contourner les vérifications de sécurité sans avoir identifié la cause du refus.

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 configurationfonctionnement de Medulla.

Si un relais reste invisible :

Si le problème persiste, consulter

Vérifier l'état

/root/enable_relay_display.sh status

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

Il est déconseillérecommandé de déplacer ou supprimerconserver le script à son emplacement initial tant qu'une automatisation est active.

En particulier, unele tâchemode cron peut utiliserutilise le chemin du script enregistré lors de son l'installation.

Si cele fichier est déplacé ou supprimé, les prochaines exécutions risquentautomatiques d'peuvent échouer.

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

Attention

28. Quelles sont les bonnes pratiques recommandées ?

29.28. Quelle procédure suivre pour une première installationutilisation ?

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

Étape 1 —: Vérifiervérifier l'environnement

sudo /root/enable_relay_display.sh status

Étape 2 —: Effectuereffectuer une simulation

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

Étape 3 —: Appliquerappliquer les règles manquantes

sudo /root/enable_relay_display.sh run

Étape 4 —: Vérifiervérifier le résultat

sudo /root/enable_relay_display.sh status

Étape 5 —: Installervérifier l'automatisationla visibilité dans Medulla

SiSe connecter à l'interface Medulla et contrôler que les résultatsrelais attendus sont conformesvisibles auxpour attentesles utilisateurs concernés.

Étape 6 : installer une automatisation si nécessaire

Pour une automatisation toutes les 15 minutes :

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

Étape 67 —: Contrôlercontrôler l'installation

sudo /root/enable_relay_display.sh status

LaSuccès configuration:
Lorsque les vérifications sont satisfaisantes et que l'automatisation est alorsactive, les nouveaux relais pourront être pris en place.compte automatiquement lors des prochains passages.

30.29. Récapitulatif des commandes

/root/enable_relay_display.sh --help

/root/enable_relay_display.sh menu

/root/enable_relay_display.sh status

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

/root/enable_relay_display.sh run

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

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

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

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

Exemple :

sudo/root/enable_relay_display.sh reactivate

Afficher les messages en anglais

/root/enable_relay_display.sh status --lang en

En30. résuméRecommandations

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

Pour utiliser le script dans les meilleures conditions :

Pour maintenir automatiquementavant la visibilitépremière desutilisation.

En résumé :
Pour rendre immédiatement tous les relais visibles, utiliser run.
Pour maintenir automatiquement leur visibilité, utiliser install-cron ou install-proc.
Pour vérifier la configuration, utiliser status.
Pour annuler une opération, utiliser le fichier de revenirrollback sur les opérations réalisées.correspondant.