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 ;
  • macOSmacOS.

Information :
Le script est développé en Python. Celui-ciPython é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 (Downloads)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 :

  • Lele poste possède un agent Medulla installé.installé ;
  • Lele script a été téléchargé localement.localement ;
  • Vousvous disposez dedes droits administrateur (recommandé).sur le poste ;
  • Lele poste est connecté au réseau.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

Placez-vousDepuis le menu Démarrer :

    Recherchez PowerShell. Effectuez un clic droit sur Windows PowerShell ou Terminal. Sélectionnez Exécuter en tant qu'administrateur. 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 contenantdu lescript script.avec PowerShell

    cd "%USERPROFILE%\$env:USERPROFILE\Downloads"

    PuisSi lancezle 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 reconnuereconnue, 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 :
    LePython Pythonest installé avec Medullal'agent estMedulla. automatiquementSelon utiliséla pourconfiguration exécuterdu leposte, script.la commande disponible peut être python ou py.

    Exécution sous Linux

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

    Placez-vous dans le dossier contenant le script.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 peutdoit ê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

    PermetCe 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

    ouOu :

    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

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

    Windows :

    python medulla_diagnostic_monolithic.py -o C:\Temp

    Linux / macOS:

    sudo python3 medulla_diagnostic_monolithic.py -o /tmp

    macOS :

    sudo python3 medulla_diagnostic_monolithic.py -o /tmp

    Utiliser un dossier d'installation personnalisé

    SiUtilisez 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"

    ouLinux / macOS :

    sudo python3 medulla_diagnostic_monolithic.py -a /opt/Medulla

    Mode silencieux

    RéduitCe 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, il est recommandé de lancerlancez 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èmesystème d'exploitation ;
    • Versionversion du système ;
    • Architecturearchitecture ;
    • Nomnom de la machine ;
    • Utilisateurutilisateur courant ;
    • Versionversion de PythonPython.

    Installation de l'agent Medulla

    • Détectiondétection automatique de l'agent ;
    • Vérificationvérification de l'arborescence d'installation ;
    • Présenceprésence des principaux exécutables ;
    • Détectiondétection des plugins installésinstallés.

    Configuration de l'agent

    • Lecturelecture des fichiers de configuration ;
    • Analyseanalyse de agentconf.ini ;
    • Analyseanalyse de cluster.ini ;
    • Détectiondétection automatique du serveur Medulla ;
    • Analyseanalyse des paramètres de communicationcommunication.

    Contrôle des fichiers

    • Vérificationvérification de la présence des principaux fichiers ;
    • Calculcalcul des empreintes MD5 lorsque disponible ;
    • Contrôlecontrôle de la syntaxe des scripts Python de l'agentagent.

    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.

    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.

    ImportantInformation :
    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éedé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 simplement 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ésolutionrésolution du nom du serveur Medulla ;
    • Validationvalidation de l'adresse IP obtenueobtenue.

    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)— DHCP ;
    • 69 (TFTP)— 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èmesystème d'exploitation ;
    • Versionversion ;
    • Architecturearchitecture ;
    • Nomnom de la machine ;
    • Utilisateurutilisateur courant ;
    • Versionversion de PythonPython.

    Configuration Medulla

    • Configurationconfiguration de l'agent ;
    • Configurationconfiguration du cluster ;
    • Serveurserveur Medulla configuré ;
    • Pluginsplugins installés ;
    • Paramètresparamètres réseauréseau.

    Contrôle des fichiers

    • Présenceprésence des fichiers principaux ;
    • Contrôlecontrôle d'intégrité (avec empreinte MD5 lorsque disponible)disponible ;
    • Vérificationvérification de la syntaxe des scripts PythonPython.

    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 queuniquement 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, merci de joindrejoignez à 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.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.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.

      Fonctionne-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-PremisePremise.

      Bonnes pratiques

      • Exécuterexécuter systématiquement le diagnostic avec undes comptedroits administrateur lorsque cela est possible.;
      • Nelancer le script directement sur le poste concerné ;
      ne pas interrompre le script avant la fin de son exécution.exécution ; Toujourstoujours transmettre l'archive ZIP complète.complète ; Éviterne depas modifier les fichiers générés.générés ; Relancerrelancer un nouveau diagnostic après toute modification de configuration.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. DansCette la majorité des cas, celaprocédure permet de réduire significativement le temps dené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 (installéinstallation avecsupplémentaire l'agent)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 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 avantavec toutedes demandedroits administrateur et la transmission de supportl'archive permetZIP complète permettent de réduire les échanges et d'accélérer significativement la résolution des incidents.problèmes liés à l'agent.

      Back to top