Skip to main content

Problème d'agent Windows

S'applique à : Medulla
Version : Toutes
Environnement : Windows / ToutesLinux versions/ macOS / SaaS Public et/ privéSaaS et On premisePrivé / MaintenanceOn-Premise
Catégorie : Diagnostic / Agent / Connectivité

Présentation

VotreAfin problèmede concernefaciliter unele interactiondiagnostic entredes Medullaincidents etrencontrés sur un poste Windowsadministré par Medulla (agent quine 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 remontebloque pas,pas actionsnécessairement nonle appliquées,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 invisible,et etc.)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, Medullale metscript àcollecte dispositionautomatiquement un scriptensemble ded'informations vérificationtechniques quiconcernant permet de contrôler la connectivité réseau, l’état de l’agent et la configuration dule poste.

                      Téléchargement

                      Informations du script :


                      https://dl.medulla-tech.io/nc/windows_connection_check_signed.ps1

                      (clique droit sur le lien ci-dessous, puis cliquez sur "Enregister le lien sous...")

                      Prérequis aux tests

                      Avant de commencer, assurez-vous d’avoir récupéré le script ci-dessus et de préparer les machines.

                      Sur le poste client Windows possédant l’agent Medulla :

                      système
                      • FaireSystème und'exploitation
                      clicVersion droitArchitecture surNom le script cliquer sur propriétés, cocherde la casemachine débloquerUtilisateur l'executioncourant duVersion scriptde  et valider.Python

                      image.png

                      Configuration Medulla

                      • AutorisezConfiguration l’exécutionde desl'agent
                      scriptsConfiguration PowerShelldu :cluster Serveur Medulla configuré Plugins installés Paramètres réseau

                      Set-ExecutionPolicy

                      Contrôle -Scopedes CurrentUserfichiers

                      -ExecutionPolicy
                      RemoteSignedPrésence
                      des

                      #fichiers Répondreprincipaux

                      "OuiContrôle pour tous"d'intégrité (AMD5 oulorsque T)disponible) si demandé

                      Pour powershell v7.5.4 : 

                      Il n'y a pas besoin de débloquer le script. Il faut lancez la commande vu précédemment.

                      Il vous demandera si on veut autoriser l'editeur qui publie le script il suffit de valider en cliquant sur R ou A.

                      image.png

                      Test Medulla Serveur <- Poste Client Windows

                      Vérification de la communicationsyntaxe directedes entrescripts lePython serveur et

                      Journaux

                      les

                      Les postesprincipaux clients.

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

                      SurInformation :
                      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 Postescript Clientgénère (Source)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 Lancezmodifiez pas le test vers le nom d’hôte ou l’IP du serveur.

                        .\windows_connection_check_signed.ps1 -Target <IP_DU_SERVEUR> -Mode pulse

                        Un fichiercontenu de logcette estarchive créé (à l’emplacement depuis lequel vous lancez le script) et résume les tests effectués : LOG_Test_Flux.txt

                        Si vous avez des erreurs de droits lorsavant de la créationtransmettre duau fichiersupport Medulla.

                        Transmission au support Medulla

                        Pour accélérer le traitement de log,votre essayezdemande, merci de placerjoindre à votre ticket :

                          l'archive ZIP générée par le script dans; 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 dossierscript Downloadsplusieurs fois ?

                          Oui.

                          Le script peut être exécuté autant de l’utilisateur,fois ouque donneznécessaire.

                          Fonctionne-t-il sur tous les droitsenvironnements auMedulla ?

                          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 windows_connection_check.ps1avant pourla créerfin de son exécution. Toujours transmettre l'archive ZIP complète. Éviter de modifier les fichiers générés. Relancer un fichiernouveau audiagnostic mêmeaprès emplacement.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.

                              Medulla

                              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

                              Si

                              Oui vous avez un serveur Medulla On-Premise, vous avez également la possibilité de lancer un diagnostic du serveur vers le poste :

                              Sur le Serveur Medulla (Source) : Lancez le test vers le nom d’hôte ou l’IP du poste.

                              ./medulla_connection_check.sh -c client.example.com

                              Recommandation : merci
                              L'outil de joindrediagnostic Medulla constitue le fichiermoyen LOG_Test_Flux.txtle lorsplus derapide votred'obtenir les informations nécessaires à l'analyse d'un incident. Son exécution avant toute demande de support.support permet de réduire les échanges et d'accélérer significativement la résolution des incidents.

                              Back to top