Skip to main content

Forcer le reset / réinstallation d’un agent Medulla

S'applique à : Medulla Serveur
Version : 5.6.4 et supérieures
Environnement : On-Premise
Catégorie : Agent / Diagnostic / Maintenance

À partir de la version Medulla 5.6.4, il est possible de demander au serveur Medulla de forcer le reset d'un agent.

Cette opération peut notamment être utilisée lorsqu'un agent rencontre un dysfonctionnement persistant, par exemple lorsqu'il ne se met plus à jour correctement.

Le reset est demandé en ajoutant le JID de la machine dans la table :

xmppmaster.reset_machine

Important :
Les opérations présentées dans cette documentation agissent directement sur la base de données Medulla. Elles doivent être exécutées avec précaution et uniquement par un administrateur de la plateforme.

1. Identifier le JID de la machine

Pour demander le reset d'une machine, vous devez disposer de son JID Medulla.

Le JID peut être recherché directement dans la table xmppmaster.machines.

Par exemple, pour rechercher une machine à partir d'une partie de son nom :

SELECT jid
FROM xmppmaster.machines
WHERE jid LIKE '%NOM_MACHINE%';

Exemple de JID :

spo-w11-1.o68@spo-ars01/bc241109f61e

Information :
Utilisez toujours le JID complet retourné par Medulla afin de cibler précisément la machine concernée.

2. Forcer le reset d'un agent

Pour demander le reset d'un agent précis, ajoutez son JID dans la table xmppmaster.reset_machine.

Exemple :

INSERT INTO xmppmaster.reset_machine (jid, reason)
VALUES ('spo-w11-1.o68@spo-ars01/bc241109f61e', 'Unstable agent');

Le champ reason permet d'indiquer la raison pour laquelle le reset a été demandé.

Il est recommandé d'utiliser une description permettant d'identifier facilement le motif de l'opération.

Par exemple :

INSERT INTO xmppmaster.reset_machine (jid, reason)
VALUES ('JID_DE_LA_MACHINE', 'Agent update issue');

3. Vérifier la demande de reset

Après l'insertion, vous pouvez vérifier la présence de la demande dans la table :

SELECT *
FROM xmppmaster.reset_machine
WHERE jid = 'spo-w11-1.o68@spo-ars01/bc241109f61e';

Cette vérification permet de confirmer que la demande de reset a bien été enregistrée.

4. Forcer le reset de tous les agents

Il est également possible de demander le reset de tous les agents de type machine enregistrés dans Medulla.

Avant d'effectuer cette opération, il est fortement recommandé de vérifier la liste des machines concernées :

SELECT jid
FROM xmppmaster.machines
WHERE agenttype = 'machine';

Pour demander ensuite le reset de l'ensemble de ces agents :

INSERT INTO xmppmaster.reset_machine (jid, reason)
SELECT jid, 'Reset all agents'
FROM xmppmaster.machines
WHERE agenttype = 'machine';

Attention :
Cette commande concerne l'ensemble des agents de type machine enregistrés dans Medulla. Elle ne doit pas être utilisée pour traiter un incident isolé sur un seul poste.

5. Vérifier le nombre de machines avant un reset global

Avant d'effectuer un reset global, vous pouvez vérifier le nombre d'agents concernés avec :

SELECT COUNT(*)
FROM xmppmaster.machines
WHERE agenttype = 'machine';

Vous pouvez également afficher exactement les données qui seront utilisées pour alimenter la table de reset :

SELECT jid, 'Reset all agents' AS reason
FROM xmppmaster.machines
WHERE agenttype = 'machine';

Recommandation :
Exécutez toujours cette requête de contrôle avant la commande INSERT ... SELECT afin de vérifier le périmètre de l'opération.

6. Cas d'utilisation

Le reset d'un agent peut notamment être utilisé dans les situations suivantes :

  • un agent ne se met plus à jour correctement ;
  • un agent reste dans un état incohérent malgré les opérations habituelles de diagnostic ;
  • le support Medulla demande explicitement de forcer le reset de l'agent ;
  • une opération de maintenance nécessite le reset d'un ensemble d'agents.

Important :
Le reset d'un agent ne doit pas constituer la première action de diagnostic. En cas de dysfonctionnement d'un agent, il est recommandé de commencer par identifier l'origine du problème et, si nécessaire, d'utiliser l'outil de diagnostic Medulla.

7. Reset d'un agent ou reset global ?

Besoin Méthode recommandée
Problème sur une seule machine Ajouter uniquement le JID de la machine dans xmppmaster.reset_machine
Agent qui ne se met plus à jour Reset individuel après diagnostic
Plusieurs machines identifiées Insérer uniquement les JID des machines concernées
Reset de l'ensemble du parc Utiliser INSERT ... SELECT après vérification du périmètre

8. Bonnes pratiques

  • privilégier le reset d'une seule machine lorsqu'un incident est isolé ;
  • vérifier le JID avant d'insérer la demande de reset ;
  • renseigner une raison explicite dans le champ reason ;
  • contrôler le nombre de machines avant toute opération globale ;
  • ne pas utiliser le reset global pour résoudre un problème concernant seulement quelques machines ;
  • effectuer un diagnostic de l'agent avant de demander son reset lorsque l'origine du problème n'est pas connue.

Recommandation :
En cas de problème sur un agent Medulla, privilégiez toujours un reset ciblé à partir du JID de la machine concernée. Le reset global de l'ensemble des agents doit rester une opération exceptionnelle et maîtrisée.

Back to top