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.

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 – Choisir la bonne méthode de reconfiguration

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’interface Medulla :

  1. Rechercher la machine concernée
  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

Cette mé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 :

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

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, utiliser la procédure MariaDB ci-dessous.

Important :
Avant toute exécution globale en 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 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 des machines en ligne est effectuée par batch de 240 machines toutes les 60 secondes par défaut.
  • Les machines éteintes ou hors ligne appliqueront automatiquement la reconfiguration lors de leur prochaine connexion au serveur Medulla.
  • Selon le nombre total de postes concernés, la remontée complète des inventaires peut prendre plusieurs 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
Back to top