Comment forcer la reconfiguration des agents Medulla ?

S'applique àà : Medulla –– Serveur
Version : Toutes versions
Environnement : On-Premise
CatégorieCatégorie : Agent Medulla / Reconfiguration

Cette procédureprocédure permet de forcer la reconfiguration des agents Medulla.

Lorsqu’Lorsqu’un agent est marquémarqué avec need_reconf=1, celui-ci effectue automatiquement les actions suivantes :

• 1. Redemande de configuration au substitut assesseur
  L’L’agent redemande sa configuration complètecomplète au substitut assesseur afin de récupérerrécupérer les paramètresparamètres àà jour.
• 2. RéenregistrementRéenregistrement de l’l’agent
  L’L’agent se connecte au relais XMPP fourni par l’l’assesseur puis réaliseréalise un nouvel enregistrement.
• 3. RemontéeRemontée d’d’un inventaire complet
  L’L’agent déclenchedéclenche automatiquement un inventaire complet du poste et le renvoie au serveur Medulla.

Il s’s’agit exactement du mêmemême mécanismemécanisme utiliséutilisé par la Quick Action "Reconfigure machine agent" disponible dans l’l’interface Medulla.

Important :
Avant toute exécution globale en base, il est fortement recommandé de réaliser un test sur une machine unique en utilisant la Quick Action "Reconfigure machine agent" afin de valider le comportement attendu.

Sauvegarde recommandéerecommandée :
Avant toute modification en base MariaDB, réaliserréaliser un dump de la base ou une sauvegarde complètecomplète du serveur Medulla.

---

ÉtapeÉtape 1 –– TesterChoisir la bonne méthode de reconfiguration

sur

Cas 1 – Reconfiguration d’une machine unique

Pour reconfigurer une seule machine, il est recommandé d’utiliser la Quick Action "Reconfigure machine agent".

Depuis l’l’interface Medulla :

1. Rechercher unela machine de testconcernée
2. Ouvrir les Actions rapides (Quick Actions)
3. Cliquer sur "Reconfigure machine agent"
4. VérifierVérifier que le poste se réenregistreréenregistre correctement et remonte un inventaire

UneCette foisméthode est la plus simple et la plus sûre pour un besoin ponctuel.

Cas 2 – Reconfiguration d’un groupe de machines

Si vous devez reconfigurer un nombre limité de postes, il est recommandé de :

Créer un groupe Medulla contenant les machines concernées Appliquer ensuite la Quick Action "Reconfigure machine agent" sur le testgroupe validé

Cette méthode permet de contrôler précisément le périmètre impacté avant une opération plus large.

Cas 3 – Reconfiguration globale de toutes les machines

Pour reconfigurer l’ensemble du parc, vous pouvez appliquerutiliser la procédureprocédure MariaDB ci-dessous.

Important :
Avant toute exécution globale en base.base, il est fortement recommandé de réaliser un test sur une machine unique via la Quick Action "Reconfigure machine agent" afin de valider le comportement attendu.

---

ÉtapeÉtape 2 –– Sauvegarder la base MariaDB

1. Se connecter en SSH sur le serveur Medulla

ssh root@IP_DU_SERVEUR

2. CréerCréer un dossier de sauvegarde (optionnel)

mkdir -p /root/backup_medulla

3. RéaliserRéaliser un dump complet de MariaDB

mysqldump --all-databases > /root/backup_medulla/backup_medulla_$(date +%F).sql

4. VérifierVérifier la sauvegarde

ls -lh /root/backup_medulla/

VérifierVérifier que le fichier .sql est bien présentprésent avant de poursuivre.

---

ÉtapeÉtape 3 –– AccéderAccéder àà MariaDB

1. Ouvrir la console MariaDB

mysql

Vous devez obtenir un prompt similaire àà :

MariaDB [(none)]>

2. VérifierVérifier la base xmppmaster

show databases;

---

ÉtapeÉtape 4 –– Forcer la reconfiguration globale des agents

ExécuterExécuter la commande suivante :

update xmppmaster.machines
set need_reconf=1
where agenttype='machine';

Cette commande force la reconfiguration de tous les agents de type machine.

Lors de leur prochaine communication avec Medulla, les agents :

• Redemanderont leur configuration au substitut assesseur
• Se reconnecteront au relais XMPP et se réenregistrerontréenregistreront
• RéaliserontRéaliseront un inventaire complet

---

ÉtapeÉtape 5 –– Quitter MariaDB

exit

---

Quand les changements seront-ils visibles ?

• La reconfiguration serades effectuéemachines lorsen ligne est effectuée par batch de la240 prochainemachines communicationtoutes deles l’agent60 avecsecondes lepar serveur Medulla.défaut.
• Les machines éteinteséteintes ou hors ligne appliqueront automatiquement la reconfiguration àlors de leur prochaine connexion.connexion au serveur Medulla.
• Selon le nombre total de postes,postes concernés, la remontéeremontée complètecomplète des inventaires peut prendre plusieurs heures.heures.

Après reconfiguration, chaque agent :

Redemande sa configuration au substitut assesseur Se reconnecte au relais XMPP et se réenregistre Renvoie un inventaire complet