Skip to main content

Problème d'agent Windows / Linux / Mac

S'applique à : Medulla
Version : Toutes
Environnement : Windows / Linux / macOS / SaaS Public / SaaS Privé / On-Premise
Catégorie : Diagnostic / Agent / Connectivité

Présentation

Afin de faciliter le diagnostic des incidents rencontrés sur un poste administré par Medulla — agent ne remontant plus, inventaire incomplet, déploiement impossible, problème de communication avec le serveur, etc. — Medulla met à disposition un outil de diagnostic multiplateforme.

Ce script réalise automatiquement plusieurs dizaines de vérifications sur le poste afin d'aider les équipes support à identifier rapidement l'origine du problème.

Contrairement à l'ancien script PowerShell réservé aux postes Windows, ce nouvel outil fonctionne sur :

  • Windows ;
  • Linux ;
  • macOS.

Information :
Le script est développé en Python. Python étant installé automatiquement avec l'agent Medulla, aucune installation supplémentaire n'est normalement nécessaire sur les postes administrés.

Important :
Le diagnostic doit impérativement être exécuté avec un compte disposant des droits administrateur. Sous Linux et macOS, utilisez sudo. Sans ces privilèges, certaines vérifications et certaines collectes de journaux peuvent être incomplètes.

Téléchargement du script

Téléchargez le script de diagnostic depuis le lien suivant :

https://dl.medulla-tech.io/nc/medulla_diagnostic_monolithic.py

Sous la plupart des navigateurs, effectuez un clic droit sur le lien puis choisissez :

Enregistrer le lien sous...

Conseil :
Placez le script dans le dossier Téléchargements ou Downloads de l'utilisateur afin de le retrouver facilement ainsi que les rapports générés.

Prérequis

Avant d'exécuter le diagnostic, vérifiez les points suivants :

  • le poste possède un agent Medulla installé ;
  • le script a été téléchargé localement ;
  • vous disposez des droits administrateur sur le poste ;
  • le poste est connecté au réseau ;
  • le script est exécuté directement depuis le poste concerné par le problème.

Important :
Pour obtenir un diagnostic complet, le script doit être exécuté avec des privilèges élevés : console ouverte en tant qu'administrateur sous Windows ou commande exécutée avec sudo sous Linux et macOS.

Information :
Le script n'effectue aucune modification de la configuration du poste. Il réalise uniquement des contrôles et collecte les informations nécessaires au diagnostic.

Exécution sous Windows

Ouvrez une console PowerShell ou une Invite de commandes en tant qu'administrateur.

Ouvrir PowerShell en tant qu'administrateur

Depuis le menu Démarrer :

  1. Recherchez PowerShell.
  2. Effectuez un clic droit sur Windows PowerShell ou Terminal.
  3. Sélectionnez Exécuter en tant qu'administrateur.
  4. Validez la demande du contrôle de compte utilisateur.

Important :
La mention Administrateur doit apparaître dans le titre de la fenêtre. Dans le cas contraire, fermez la console et ouvrez-la de nouveau avec les privilèges administrateur.

Se placer dans le dossier du script avec PowerShell

cd "$env:USERPROFILE\Downloads"

Si le dossier porte le nom français Téléchargements, Windows utilise généralement malgré tout le chemin système Downloads.

Lancer le diagnostic avec PowerShell

python medulla_diagnostic_monolithic.py

Si la commande python n'est pas reconnue, essayez :

py medulla_diagnostic_monolithic.py

Exécution depuis l'Invite de commandes

Ouvrez l'Invite de commandes en tant qu'administrateur, puis exécutez :

cd /d "%USERPROFILE%\Downloads"

Puis :

python medulla_diagnostic_monolithic.py

Ou, si nécessaire :

py medulla_diagnostic_monolithic.py

Information :
Python est installé avec l'agent Medulla. Selon la configuration du poste, la commande disponible peut être python ou py.

Exécution sous Linux

Ouvrez un terminal avec un compte autorisé à utiliser sudo.

Placez-vous dans le dossier contenant le script :

cd ~/Downloads

Puis exécutez le diagnostic avec les droits administrateur :

sudo python3 medulla_diagnostic_monolithic.py

Selon votre distribution, la commande suivante peut également fonctionner :

sudo python medulla_diagnostic_monolithic.py

Le mot de passe du compte courant peut être demandé par sudo.

Important :
N'exécutez pas uniquement la commande python3 medulla_diagnostic_monolithic.py sans sudo. Le script pourrait ne pas accéder à certains fichiers de configuration, services ou journaux nécessaires au support.

Exécution sous macOS

Ouvrez l'application Terminal avec un compte disposant des droits administrateur sur le Mac.

Placez-vous dans le dossier où le script a été téléchargé :

cd ~/Downloads

Puis lancez le diagnostic avec les privilèges administrateur :

sudo python3 medulla_diagnostic_monolithic.py

Le mot de passe du compte administrateur macOS peut être demandé.

Important :
L'utilisation de sudo est nécessaire afin de permettre au script d'accéder aux informations système, aux fichiers de configuration et aux journaux utiles au diagnostic.

Information :
Le script détecte automatiquement qu'il est exécuté sous macOS et adapte les vérifications réalisées.

Paramètres disponibles

Dans la majorité des cas, le script doit être lancé sans aucun paramètre.

Il détecte automatiquement :

  • le système d'exploitation ;
  • le dossier d'installation de l'agent ;
  • les fichiers de configuration ;
  • le serveur Medulla configuré ;
  • les principaux paramètres réseau.

Il est néanmoins possible de personnaliser son fonctionnement.

Spécifier un serveur Medulla

Ce paramètre permet de tester un serveur différent de celui configuré dans l'agent.

Windows :

python medulla_diagnostic_monolithic.py -s serveur.medulla.local

Ou :

python medulla_diagnostic_monolithic.py --server 192.168.1.20

Linux / macOS :

sudo python3 medulla_diagnostic_monolithic.py -s serveur.medulla.local

Ou :

sudo python3 medulla_diagnostic_monolithic.py --server 192.168.1.20

Choisir le dossier de sortie

Ce paramètre permet d'enregistrer le rapport de diagnostic dans un autre répertoire.

Windows :

python medulla_diagnostic_monolithic.py -o C:\Temp

Linux :

sudo python3 medulla_diagnostic_monolithic.py -o /tmp

macOS :

sudo python3 medulla_diagnostic_monolithic.py -o /tmp

Utiliser un dossier d'installation personnalisé

Utilisez ce paramètre si l'agent Medulla n'est pas installé dans son emplacement par défaut.

Windows :

python medulla_diagnostic_monolithic.py -a "C:\Program Files\Medulla"

Linux / macOS :

sudo python3 medulla_diagnostic_monolithic.py -a /opt/Medulla

Mode silencieux

Ce paramètre réduit les informations affichées pendant l'exécution.

Windows :

python medulla_diagnostic_monolithic.py -q

Linux / macOS :

sudo python3 medulla_diagnostic_monolithic.py -q

Conseil :
Pour une utilisation standard, lancez le script sans paramètre afin qu'il récupère automatiquement la configuration de l'agent Medulla.

Tests réalisés automatiquement

Le script effectue automatiquement plusieurs dizaines de contrôles destinés à vérifier le bon fonctionnement du poste administré.

Informations système

  • système d'exploitation ;
  • version du système ;
  • architecture ;
  • nom de la machine ;
  • utilisateur courant ;
  • version de Python.

Installation de l'agent Medulla

  • détection automatique de l'agent ;
  • vérification de l'arborescence d'installation ;
  • présence des principaux exécutables ;
  • détection des plugins installés.

Configuration de l'agent

  • lecture des fichiers de configuration ;
  • analyse de agentconf.ini ;
  • analyse de cluster.ini ;
  • détection automatique du serveur Medulla ;
  • analyse des paramètres de communication.

Contrôle des fichiers

  • vérification de la présence des principaux fichiers ;
  • calcul des empreintes MD5 lorsque disponible ;
  • contrôle de la syntaxe des scripts Python de l'agent.

Collecte des journaux

Les principaux journaux de l'agent Medulla sont automatiquement collectés afin de faciliter le diagnostic.

Important :
Certains journaux ne sont accessibles qu'avec des droits administrateur. C'est pourquoi le script doit être lancé depuis une console administrateur sous Windows ou avec sudo sous Linux et macOS.

Tests réseau

Le script vérifie également la connectivité réseau entre le poste et la plateforme Medulla.

Information :
Le script n'effectue aucune modification sur le poste. Il réalise uniquement des opérations de lecture, de vérification et de collecte d'informations destinées au support Medulla.

Analyse des résultats

À l'issue de son exécution, le script affiche un résumé des principaux contrôles réalisés.

Chaque test est identifié comme :

  • OK : le contrôle est valide ;
  • WARNING : une anomalie a été détectée, mais elle ne bloque pas nécessairement le fonctionnement ;
  • ERROR : le test a échoué et nécessite une investigation.

Information :
Un ou plusieurs avertissements ne signifient pas nécessairement que Medulla ne fonctionne plus. Ils permettent d'orienter le diagnostic du support.

Attention :
Si le script n'a pas été exécuté avec des droits administrateur, certains résultats peuvent apparaître en erreur ou être absents sans que cela corresponde nécessairement à un dysfonctionnement de Medulla.

Tests réseau réalisés

Le script vérifie automatiquement la connectivité réseau entre le poste et la plateforme Medulla.

Résolution DNS

  • résolution du nom du serveur Medulla ;
  • validation de l'adresse IP obtenue.

Connectivité TCP

Le script teste automatiquement les principaux ports utilisés par Medulla.

Port Service
22 SSH
80 HTTP
443 HTTPS
111 RPC Portmapper
2002 API Medulla
2049 NFS
5222 XMPP
8443 HTTPS Medulla
9990 Administration
9999 Administration alternative
22067 Service Medulla
55415 Service Medulla

Connectivité UDP

Les ports UDP suivants sont également vérifiés lorsqu'ils sont utilisés :

  • 67 — DHCP ;
  • 69 — TFTP ;
  • 111 — RPC Portmapper ;
  • 2049 — NFS.

Information :
Tous les ports ne sont pas nécessairement utilisés dans chaque environnement. Les besoins dépendent de l'architecture Medulla et des fonctionnalités activées.

Informations collectées

Afin de faciliter le diagnostic, le script collecte automatiquement un ensemble d'informations techniques concernant le poste.

Informations système

  • système d'exploitation ;
  • version ;
  • architecture ;
  • nom de la machine ;
  • utilisateur courant ;
  • version de Python.

Configuration Medulla

  • configuration de l'agent ;
  • configuration du cluster ;
  • serveur Medulla configuré ;
  • plugins installés ;
  • paramètres réseau.

Contrôle des fichiers

  • présence des fichiers principaux ;
  • contrôle d'intégrité avec empreinte MD5 lorsque disponible ;
  • vérification de la syntaxe des scripts Python.

Journaux

Les principaux journaux de l'agent sont automatiquement récupérés afin de faciliter l'analyse du support.

Information :
Le script collecte uniquement les informations nécessaires au diagnostic du fonctionnement de Medulla.

Important :
Une exécution sans droits administrateur peut produire une archive incomplète. Avant de transmettre le fichier au support, vérifiez que le script a bien été lancé avec les privilèges requis.

Archive générée

À la fin du diagnostic, le script génère automatiquement une archive ZIP contenant l'ensemble des informations collectées.

Le nom de cette archive est horodaté afin de faciliter son identification.

Exemple :

pulse_diagnostics_MONPOSTE_20260801_103245.zip

Cette archive contient notamment :

  • le rapport complet du diagnostic ;
  • les informations système ;
  • les fichiers de configuration de l'agent ;
  • les journaux collectés ;
  • les résultats des tests réseau.

Important :
Ne modifiez pas le contenu de cette archive avant de la transmettre au support Medulla.

Transmission au support Medulla

Pour permettre au support de commencer l'analyse et accélérer le traitement de votre demande, joignez à votre ticket :

  • l'archive ZIP complète générée par le script ;
  • une description précise du problème rencontré ;
  • la date et l'heure du dernier test effectué ;
  • les captures d'écran éventuelles des messages d'erreur ;
  • le nom du poste concerné.

Important :
Sans l'archive ZIP générée par le diagnostic, les équipes Medulla peuvent ne pas disposer des informations nécessaires pour commencer l'analyse d'un incident lié à l'agent.

Ces éléments permettent généralement d'identifier plus rapidement l'origine du dysfonctionnement et de limiter les échanges complémentaires.

Questions fréquentes

Le script modifie-t-il la configuration de mon poste ?

Non.

Le script effectue uniquement des opérations de lecture, de vérification et de collecte d'informations.

Dois-je installer Python ?

Non.

Le moteur Python utilisé par Medulla est installé automatiquement avec l'agent.

Les droits administrateur sont-ils obligatoires ?

Oui.

Le script doit être exécuté :

  • depuis une console ouverte en tant qu'administrateur sous Windows ;
  • avec sudo sous Linux ;
  • avec sudo sous macOS.

Sans ces droits, certains fichiers, services et journaux peuvent être inaccessibles.

Puis-je lancer le script plusieurs fois ?

Oui.

Le script peut être exécuté autant de fois que nécessaire. Une nouvelle archive horodatée est générée à chaque exécution.

Dois-je relancer le diagnostic après une modification ?

Oui.

Après toute modification de configuration, correction réseau ou réinstallation de l'agent, générez une nouvelle archive afin que le support dispose d'informations à jour.

Le script fonctionne-t-il sur tous les environnements Medulla ?

Oui.

  • SaaS Public ;
  • SaaS Privé ;
  • On-Premise.

Bonnes pratiques

  • exécuter systématiquement le diagnostic avec des droits administrateur ;
  • lancer le script directement sur le poste concerné ;
  • ne pas interrompre le script avant la fin de son exécution ;
  • toujours transmettre l'archive ZIP complète ;
  • ne pas modifier les fichiers générés ;
  • relancer un nouveau diagnostic après toute modification de configuration ;
  • indiquer dans le ticket la date et l'heure d'exécution ;
  • conserver uniquement les archives nécessaires au traitement de l'incident.

Conseil :
Avant d'ouvrir un ticket auprès du support Medulla, exécutez systématiquement ce script avec des droits administrateur et joignez l'archive générée. Cette procédure permet de réduire significativement le temps nécessaire au diagnostic.

Résumé

Élément Description
Systèmes supportés Windows, Linux et macOS
Droits administrateur Obligatoires
Commande Windows python medulla_diagnostic_monolithic.py
Commande Linux sudo python3 medulla_diagnostic_monolithic.py
Commande macOS sudo python3 medulla_diagnostic_monolithic.py
Installation de Python Aucune installation supplémentaire normalement nécessaire
Détection automatique Oui
Analyse de la configuration Oui
Analyse des journaux Oui
Contrôle de l'installation Oui
Tests réseau DNS, TCP et UDP
Archive ZIP générée Oui
Compatible SaaS Public Oui
Compatible SaaS Privé Oui
Compatible On-Premise Oui

Recommandation :
L'outil de diagnostic Medulla constitue le moyen le plus rapide d'obtenir les informations nécessaires à l'analyse d'un incident. Son exécution avec des droits administrateur et la transmission de l'archive ZIP complète permettent de réduire les échanges et d'accélérer significativement la résolution des problèmes liés à l'agent.

Back to top