# Endpoint Central Agent-Fehlerbehebungstool ### Inhaltsverzeichnis 1. [Was ist das Agent-Fehlerbehebungstool?](#was-ist-das-agent-fehlerbehebungstool) 2. [Warum ist die Fehlerbehebung für Agenten erforderlich?](#warum-ist-die-fehlerbehebung-für-agenten-erforderlich) 3. [So beheben Sie Probleme mit Endpoint Central-Agenten](#so-beheben-sie-probleme-mit-dem-endpoint-central-agenten) 4. [Zusätzliche Schritte zur Fehlerbehebung](#zusätzliche-schritte-zur-fehlerbehebung) --- ## Was ist das Agent-Fehlerbehebungstool? Endpoint Central arbeitet nach dem Prinzip der Agent-Server-Kommunikation, bei dem die Agenten auf den Rechnern der Endbenutzer gemäß der Agent-Aktualisierungsrichtlinie alle 90 Minuten den zentralen Server kontaktieren. Darüber hinaus kontaktieren die Agenten den zentralen Server beim Start des Geräts und bei Benutzeranmeldungen. Das von Endpoint Central unterstützte Agent-Fehlerbehebungstool ermöglicht es Endbenutzern, Probleme mit den Agenten selbst zu beheben und die Verbindung wiederherzustellen, anstatt ihre IT-Administratoren um Unterstützung zu bitten. ## Warum ist die Fehlerbehebung für Agenten erforderlich? Der Endpoint Central-Agent kann aufgrund von Problemen auf Netzwerkebene oder von Problemen, die den Agent-Dienst unterbrechen, ausfallen. IT-Administratoren können den Live-Status der verwalteten Agenten in der Ansicht „Verwaltungsbereich“ einsehen. Wenn ein Agent als „ausgefallen“ markiert ist (angezeigt durch ein rotes Monitor-Symbol), können IT-Administratoren eine Remote-Verbindung zu diesen Endpunkten herstellen und das Problem beheben. Ebenso können Endbenutzer den Status ihres Agenten über das Taskleistensymbol prüfen. Immer wenn das Agent-Symbol inaktiv ist, können Endbenutzer dieses Tool aufrufen und ihren Agenten beheben. Nach Abschluss des Fehlerbehebungsprozesses stellt das Tool einen detaillierten Bericht über die Kommunikationsprobleme des Agenten und deren Behebung bereit. ## So beheben Sie Probleme mit dem Endpoint Central-Agenten ### Windows Dieses Tool ist auf dem Rechner verfügbar, auf dem der Endpoint Central-Agent installiert ist. Die Fehlerbehebung kann durchgeführt werden, indem der Endbenutzer angewiesen wird, die Aktion selbst zu starten, oder indem ihm per Fernzugriff geholfen wird. Um auf das Fehlerbehebungstool zuzugreifen, klicken Sie im Agent-Taskleistensymbol auf die Option zur Fehlerbehebung. Klicken Sie auf die Schaltfläche „Fehlerbehebung starten“, um den Vorgang zu beginnen. Alternativ kann das Agent-Fehlerbehebungstool über `ManageEngine\UEMS_Agent\bin\agent_troubleshooting_tool.exe` aufgerufen werden. Das Fehlerbehebungstool wird wie im folgenden Bild angezeigt: ![Agent-Fehlerbehebungstool unterstützt von Endpoint Central](https://www.manageengine.com/products/desktop-central/help/images/agent-troubleshooting-tool-image.png) **Hinweis:** Das obige Bild zeigt einen Agenten, der direkt vom zentralen Server (OP) ohne Verteilungsserver verwaltet wird. Die Fehlerbehebungsaktion diagnostiziert die primären Probleme auf Netzwerkebene und zeigt die Ergebnisse grafisch an. Hier ist eine Liste der Informationen, die als Ergebnis dieser Fehlerbehebungsaktion abgerufen werden: - Agent-Binärdateien - Agent-Identität - Agent-Dienst - Antivirus - Verbindungsstatus zu Active Directory - Verbindungsstatus zum Verteilungsserver - Verbindungsstatus zum Benachrichtigungsserver - Verbindungsstatus zum Endpoint Central-Server - WMI-Verbindungsstatus **Hinweis:** Wenn Sie auf jede Komponente klicken, werden detaillierte Informationen zu ihrem Status angezeigt. Das Fehlerbehebungstool wird einmal alle 24 Stunden ausgeführt und speichert die Daten, die beim ersten Klick angezeigt werden. Durch Klicken auf die Schaltfläche **Erneut scannen** wird der aktuelle Verbindungsstatus abgerufen. ### Komponenten im Fehlerbehebungstool - **Agent-Dienst:** Zeigt den Status des Agent-Dienstes an und gibt an, ob er ausgeführt wird oder nicht. Wenn eine Warn- oder Fehlermeldung erscheint, bietet ein Klick auf den Dienst Zugriff auf angehängte KB-Artikel zur Problemlösung. **Hinweis:** Der Dienst **ManageEngine UEMS - Remote Control** bleibt im gestoppten Zustand und wird nur während einer Remote-Verbindung ausgeführt. Nur die Dienste ManageEngine UEMS - Agent und ManageEngine Unified Endpoint Security - Agent laufen regelmäßig. - **Agent-Identität:** Zeigt Details zum Rechnernamen des Agenten, Betriebssystemnamen, zur letzten Startzeit, zum Installationsdatum des Betriebssystems, zur Identifikationsnummer und zur UUID an. Eine Fehleranzeige tritt auf, wenn der Agent-Rechner von einem anderen Rechner geklont wurde und sich nicht vollständig wiederhergestellt hat. - **Agent-Binärdateien:** Überprüft, ob die Agent-Binärdateien während der Installation und Aktualisierung erfolgreich extrahiert wurden. Warn-/Fehlermarkierungen weisen auf eine fehlgeschlagene Extraktion hin (z. B. Software Metering Report, USB Report, Notification Server Client, Inventory Management, Patch Management). - **WMI-Verbindungsstatus:** Windows Management Instrumentation (WMI) vereinfacht die Geräte- und Anwendungsverwaltung in einem Netzwerk von Windows-Computersystemen. Wenn der Agent keine WMI-Details von Windows abrufen kann, wird ein Fehler ausgelöst. Dieser Fehler beeinträchtigt Helpdesk-Anfragen und UUID-bezogene Funktionen. - **Verbindungsstatus zu Active Directory:** Zeigt das Ergebnis der Active Directory-Verbindung an und liefert Domänen- und Gruppendetails. Falls die Verbindung fehlschlägt, können Domänendetails nicht aktualisiert werden, und domänenbezogene Patches und Konfigurationen werden nicht angewendet. - **Antivirus:** Listet installierte Antivirensoftware und die zugehörigen GUIDs auf. - **Verbindung zum Endpoint Central-Server:** Zeigt den Verbindungsstatus zwischen Agent und Server an und überprüft automatisch Ping- und Portverbindungen mit der Serveradresse. Serverbezogene Probleme werden in der Fehlerspalte hervorgehoben; Schritte zur Wiederherstellung sind in angehängten KB-Artikeln aufgeführt. Für **Endpoint Central Cloud** zeigt das Tool die Verbindung des Agenten über alle Cloud-Adressen an. Da die Cloud keine Benachrichtigungsserver-Komponente besitzt, erfolgen alle Agent-zu-Server-Aktualisierungen und On-Demand-Funktionen über die Cloud-Adressen. - **Verteilungsserver:** Überprüft die Agent-zu-DS-Verbindung mittels Ping- und Portverbindungen. Wenn der Agent unter einem Verteilungsserver arbeitet, erfolgen Konfigurationen, Patch-Bereitstellungen und Upgrades über diesen Server. **Hinweis:** Die Komponente „Verteilungsserver“ wird nur aufgeführt, wenn Agenten unter einem Verteilungsserver verwaltet werden. ![](https://www.manageengine.com/products/desktop-central/help/images/agent-ts-2.png) - **Verbindung zum Benachrichtigungsserver:** Verwaltet alle On-Demand-Aktionen wie Remote-Verbindungen, On-Demand-Konfigurationen und Patch-Bereitstellungen. Der Benachrichtigungsserver benötigt eine 10-minütige Leerlaufverbindung für Live-Statusaktualisierungen. Klicken Sie in der Zusammenfassung auf „Start“, um die Leerlaufverbindung zu prüfen. ![](https://www.manageengine.com/products/desktop-central/help/images/agent-ts-3.png) ### Zusammenfassung der Fehlerbehebung Bietet detaillierte Informationen zu Systemdetails, Agent-Version, Installationsort, Firewall-Konfigurationen sowie dem Verbindungsstatus der Agent-Komponenten. ![](https://www.manageengine.com/products/desktop-central/help/images/agent-ts-4.png) ### Protokolle anzeigen Agentenprotokolle sind über „Protokolle anzeigen“ zugänglich. Protokolle sind für jede Komponente getrennt verfügbar, z. B. Systeminformationen, Konfiguration und Patches. ![](https://www.manageengine.com/products/desktop-central/help/images/agent-ts-5.png) ### Exportieren Falls die Verbindungsprobleme nicht mithilfe der KB-Artikel behoben werden können, klicken Sie auf **Exportieren**, um alle Details mit dem Support zu teilen. ![](https://www.manageengine.com/products/desktop-central/help/images/agent-ts-6.png) ### Linux Ab Version 2203 ist das Fehlerbehebungstool im Agenten verfügbar. 1. Navigieren Sie zu **/bin**. 2. Öffnen Sie dort ein Terminal und führen Sie folgenden Befehl aus: ``` sudo ./dctroubleshootingtool ``` ![linuxTTtool](https://www.manageengine.com/products/desktop-central/help/images/linuxTTtool.png) #### Vom Fehlerbehebungstool durchgeführte Prüfungen **Produktdetails:** - Produktcode - Pfad zum Agent-Verzeichnis - Agent-Version - Name des Remote Office **Details zum Agent-Rechner:** - Hostname - FQDN - IP-Adresse - MAC-Adresse - Ressourcen-ID - Firewall- und Antivirus-Status **Details zur Serverkonnektivität:** - Erreichbarkeit des zentralen Servers, Verteilungsservers, On-Demand-Servers und Remote-Control-Servers **Patch- und Softwaredetails:** - Unterstütztes Patch-Tool (apt/yum/zypper) - Mindestens 20 GB freier Speicherplatz im Agent-Verzeichnis **Herstellerkonnektivität (nur Cloud-Agenten):** - Konnektivität zwischen Agent und jeweiligem Patch-Hersteller **Dienst- und Prozessdetails:** - Dienststatus (dcservice) - Laufende Linux-Agent-Prozesse mit PIDs ### macOS Ab Version 11.4.2544.01.M ist das Fehlerbehebungstool im macOS-Agenten verfügbar. 1. Navigieren Sie zum Agent-Taskleistensymbol in der Menüleiste und wählen Sie **Taskleistensymbol > Fehlerbehebung > Fehlerbehebungstool ausführen**. ![mac agent im Agent-Taskleistensymbol](https://www.manageengine.com/products/desktop-central/help/images/macagent-ts2.png) 2. Alternativ öffnen Sie das Terminal und führen folgenden Befehl aus: ``` /Library/ManageEngine/UEMS_Agent/bin/troubleshoot ``` ![mac agent im Agent-Taskleistensymbol](https://www.manageengine.com/products/desktop-central/help/images/macagent-ts1.png) 3. Um verfügbare Optionen anzuzeigen: ``` troubleshoot --help ``` ![mac agent im Agent-Taskleistensymbol](https://www.manageengine.com/products/desktop-central/help/images/macagent-ts3.png) **Hinweis:** Wenn das Tool ohne Optionen ausgeführt wird, werden alle Prüfungen (Netzwerk, Dienst und Informationen) gleichzeitig ausgeführt. #### Vom Fehlerbehebungstool durchgeführte Prüfungen **Details zur Serverkonnektivität:** - Verbindungsstatus mit dem Hauptserver - Verbindungsstatus mit dem Verteilungsserver - On-Demand-Funktionalität **Dienst- und Prozessdetails:** - Prüfung aller erforderlichen Dienste - Meldung inaktiver oder fehlgeschlagener Dienste **Agent- und Serverinformationen:** - Agent-Version und Installationsverzeichnis - Serveradresse und Kommunikationsdetails - MDM-Registrierungsstatus und MDM-Serveradresse **Hinweis:** Die Option `--dump` erzeugt einen Informations-Dump im Verzeichnis `/Library/ManageEngine/UEMS_Agent/logs/UserLogs/dumps`, der mit dem Support geteilt werden kann. ## Zusätzliche Schritte zur Fehlerbehebung Wenn Sie die Agent-Server-Verbindung manuell überprüfen möchten, befolgen Sie die folgenden Schritte: ### Offene Ports überprüfen Führen Sie in der Eingabeaufforderung aus: ``` telnet ``` Ein leerer Bildschirm zeigt eine erfolgreiche Verbindung an. macOS: ``` nc -vz ``` ### Datenübertragung prüfen - Greifen Sie über Ihren Browser auf die Produktkonsole zu. - Wenn die Datenübertragung blockiert ist, lässt sich die EC-Serverkonsole nicht öffnen. ### Dateidownload testen Rufen Sie im Browser des Agent-Rechners folgende URL auf: ``` https://:/client-data/ns-status-details.xml ``` Wenn eine `.xml`-Datei angezeigt und heruntergeladen werden kann, ist die Verbindung erfolgreich.