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. Celui-ci étant installé automatiquement avec l'agent Medulla, aucune installation supplémentaire n'est nécessaire sur les postes administrés.

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 (Downloads) de l'utilisateur afin de retrouver facilement 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 de droits administrateur (recommandé).
  • Le poste est connecté au réseau.

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.

Placez-vous dans le dossier contenant le script.

cd "%USERPROFILE%\Downloads"

Puis lancez le diagnostic :

python medulla_diagnostic_monolithic.py

Si la commande python n'est pas reconnue :

py medulla_diagnostic_monolithic.py

Information :
Le Python installé avec Medulla est automatiquement utilisé pour exécuter le script.

Exécution sous Linux

Ouvrez un terminal.

Placez-vous dans le dossier contenant le script.

cd ~/Downloads

Puis exécutez :

python3 medulla_diagnostic_monolithic.py

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

python medulla_diagnostic_monolithic.py

Exécution sous macOS

Ouvrez l'application Terminal.

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

cd ~/Downloads

Puis lancez le diagnostic :

python3 medulla_diagnostic_monolithic.py

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 peut ê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

Permet de tester un serveur différent de celui configuré dans l'agent.

python medulla_diagnostic_monolithic.py -s serveur.medulla.local

ou

python medulla_diagnostic_monolithic.py --server 192.168.1.20

Choisir le dossier de sortie

Permet d'enregistrer le rapport de diagnostic dans un autre répertoire.

Windows

python medulla_diagnostic_monolithic.py -o C:\Temp

Linux / macOS

python3 medulla_diagnostic_monolithic.py -o /tmp

Utiliser un dossier d'installation personnalisé

Si l'agent Medulla n'est pas installé dans son emplacement par défaut.

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

ou

python3 medulla_diagnostic_monolithic.py -a /opt/Medulla

Mode silencieux

Réduit les informations affichées pendant l'exécution.

python medulla_diagnostic_monolithic.py -q

Conseil :
Pour une utilisation standard, il est recommandé de lancer 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.

Tests réseau

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

Les détails des ports testés, des informations collectées ainsi que le contenu de l'archive générée sont décrits dans la seconde partie de cette documentation.

Important :
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 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 simplement d'orienter le diagnostic du support.

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
  • 2049

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é (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 ne collecte que les informations nécessaires au diagnostic du fonctionnement de Medulla.

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 accélérer le traitement de votre demande, merci de joindre à votre ticket :

  • l'archive ZIP 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.

Ces éléments permettent généralement d'identifier rapidement l'origine du dysfonctionnement.

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.

Puis-je lancer le script plusieurs fois ?

Oui.

Le script peut être exécuté autant de fois que nécessaire.

Fonctionne-t-il sur tous les environnements Medulla ?

Oui.

  • SaaS Public
  • SaaS Privé
  • On-Premise

Bonnes pratiques

  • Exécuter le diagnostic avec un compte administrateur lorsque cela est possible.
  • Ne pas interrompre le script avant la fin de son exécution.
  • Toujours transmettre l'archive ZIP complète.
  • Éviter de modifier les fichiers générés.
  • Relancer un nouveau diagnostic après toute modification de configuration.

Conseil :
Avant d'ouvrir un ticket auprès du support Medulla, exécutez systématiquement ce script et joignez l'archive générée. Dans la majorité des cas, cela permet de réduire significativement le temps de diagnostic.

Résumé

Élément Description
Systèmes supportés Windows, Linux et macOS
Installation de Python Aucune (installé avec l'agent)
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
Contrôle des principaux ports Oui
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 avant toute demande de support permet de réduire les échanges et d'accélérer significativement la résolution des incidents.

Back to top