Skip to main content

Comment forcer la reconfiguration des agents Medulla ?

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

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

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

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

Il s’agit exactement du même mécanisme utilisé par la Quick Action "Reconfigure machine agent" disponible dans 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ée :
Avant toute modification en base MariaDB, réaliser un dump de la base ou une sauvegarde complète du serveur Medulla.

Étape 1 – Tester la reconfiguration sur une machine

Depuis l’interface Medulla :

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

Une fois le test validé, vous pouvez appliquer la procédure globale en base.

Étape 2 – Sauvegarder la base MariaDB

1. Se connecter en SSH sur le serveur Medulla

ssh root@IP_DU_SERVEUR

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

mkdir -p /root/backup_medulla

3. Réaliser un dump complet de MariaDB

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

4. Vérifier la sauvegarde

ls -lh /root/backup_medulla/

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

Étape 3 – Accéder à MariaDB

1. Ouvrir la console MariaDB

mysql

Vous devez obtenir un prompt similaire à :

MariaDB [(none)]>

2. Vérifier la base xmppmaster

show databases;

Étape 4 – Forcer la reconfiguration globale des agents

Exé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éenregistreront
  • Réaliseront un inventaire complet

Étape 5 – Quitter MariaDB

exit
Quand les changements seront-ils visibles ?
  • La reconfiguration sera effectuée lors de la prochaine communication de l’agent avec le serveur Medulla.
  • Les machines éteintes ou hors ligne appliqueront la reconfiguration à leur prochaine connexion.
  • Selon le nombre de postes, la remontée complète des inventaires peut prendre plusieurs heures.
Back to top