> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/de/systemadministration/node-diagnostics.md). # Leitfaden zur Knotendiagnose ## Übersicht Das Node Diagnostics-Tool bietet umfassende Funktionen zur Fehlerbehebung auf Hardware- und Systemebene für einzelne VergeOS-Knoten. Diese Diagnosebefehle ermöglichen es Systemadministratoren, detaillierte Hardwareanalysen durchzuführen, die Systemleistung zu überwachen und knotenspezifische Probleme direkt über die VergeOS-Oberfläche zu beheben. {% hint style="info" %} **Was Sie lernen werden** * So greifen Sie auf Knoten-Diagnosetools zu und verwenden sie * Verständnis jedes Diagnosebefehls und seines Hardware-Fokus * Best Practices für die Fehlerbehebung auf Knotenebene * Wann bestimmte Diagnosebefehle bei Hardwareproblemen verwendet werden sollten {% endhint %} ## Voraussetzungen * Zugriff auf die VergeOS-Oberfläche mit Berechtigungen zur Knotenverwaltung * Grundlegendes Verständnis der Server-Hardwarekomponenten * Kenntnisse über Netzwerk- und Speicherkonzepte {% hint style="info" %} **Knotenzugriff** Knotendiagnosen bieten tiefen Zugriff auf Hardwareebene und sollten von erfahrenen Systemadministratoren verwendet werden. {% endhint %} ## Aufrufen der Knotendiagnosen 1. **Navigieren Sie zu Knoten-Diagnosen:** * Wählen Sie **Infrastruktur** > **Knoten** im oberen Menü aus. * Wählen Sie die gewünschte **Knoten** aus der Liste * Klicken Sie **Diagnosen** im linken Menü 2. **Diagnosebefehle verwenden:** * Wählen Sie den gewünschten Befehl aus dem **Abfrage** Dropdown-Menü * Konfigurieren Sie die verfügbaren Parameter auf der rechten Seite * Klicken Sie **Senden →** um den Befehl auszuführen {% hint style="success" %} **Sichtbarkeit der Befehle** Aktivieren Sie **„Befehl anzeigen“** um den exakt ausgeführten Befehl anzuzeigen; nützlich für die Ausführung per SSH oder die Skriptautomatisierung. {% endhint %} ## Referenz der Diagnosebefehle ### ARP-Scan **Zweck:** Ermittelt aktive Geräte auf den Netzwerkschnittstellen des Knotens mithilfe von ARP-Paketen. **Wann verwenden:** * Überprüfung der Netzwerkverbindung aus Sicht des Knotens * Identifizierung von Geräten in den lokalen Netzwerksegmenten des Knotens * Fehlerbehebung bei der Netzwerkkonfiguration des Knotens **Parameter:** * **Schnittstelle:** Netzwerkschnittstelle, von der aus gescannt werden soll **CLI-Syntax:** ```bash nmap -sn [NETZWERKBEREICH] ``` *** ### ARP-Tabelle **Zweck:** Zeigt den ARP-Cache des Knotens mit IP-zu-MAC-Adresszuordnungen an. **Wann verwenden:** * Fehlerbehebung bei der Netzwerkverbindung des Knotens * Überprüfung der Erkennung von Netzwerknachbarn * Prüfung auf ARP-Konflikte, die den Knoten betreffen **CLI-Syntax:** ```bash arp -a ``` *** ### Bridge-Adressen **Zweck:** Zeigt MAC-Adress-Tabellen für Netzwerk-Bridges auf dem Knoten an. **Wann verwenden:** * Fehlerbehebung bei der Konfiguration der Netzwerk-Bridge * Überprüfung des MAC-Lernens auf virtuellen Switches * Analyse der Netzwerktopologie **CLI-Syntax:** ```bash brctl showmacs [BRIDGE_NAME] ``` *** ### Persistenten Speicher löschen **Zweck:** Löscht Caches und temporäre Daten des persistenten Speichers auf dem Knoten. **Wann verwenden:** * Behebung von leistungsbezogenen Speicherproblemen * Löschen beschädigter Cache-Daten * Vorbereitung auf die Neukonfiguration des Speichers {% hint style="danger" %} **Warnung vor Auswirkungen auf Daten** Dieser Befehl kann die Systemleistung beeinträchtigen und sollte nur unter Anleitung des Supports verwendet werden. {% endhint %} **CLI-Syntax:** ```bash sync && echo 3 > /proc/sys/vm/drop_caches ``` *** ### DMI-Tabelle **Zweck:** Zeigt Informationen der Desktop Management Interface (DMI) einschließlich Hardwaredetails an. **Wann verwenden:** * Hardware-Inventarisierung und -Identifizierung * Überprüfung der Systemspezifikationen * Fehlerbehebung bei Hardware-Kompatibilität **CLI-Syntax:** ```bash dmidecode ``` *** ### DNS-Abfrage **Zweck:** Testet die DNS-Auflösung aus Sicht des Knotens. **Wann verwenden:** * Fehlerbehebung bei der DNS-Konfiguration des Knotens * Überprüfung der externen Konnektivität vom Knoten aus * Testen von Namensauflösungsdiensten **Parameter:** * **Hostname:** Zu auflösender Ziel-Hostname * **DNS-Server:** Spezifischer DNS-Server, der abgefragt werden soll **CLI-Syntax:** ```bash nslookup [HOSTNAME] dig [HOSTNAME] ``` *** ### Ethernet-Tool **Zweck:** Bietet detaillierte Informationen und Konfigurationen der Ethernet-Schnittstellen. **Wann verwenden:** * Diagnose von Netzwerkschnittstellenproblemen * Überprüfung von Linkgeschwindigkeit und Duplex-Einstellungen * Fehlerbehebung bei der physischen Netzwerkverbindung **Parameter:** * **Schnittstelle:** Zu prüfende Netzwerkschnittstelle **CLI-Syntax:** ```bash ethtool [INTERFACE] ``` *** ### Fabric-Konfiguration **Zweck:** Zeigt die Fabric-Netzwerkkonfiguration von VergeOS für den Knoten an. **Wann verwenden:** * Fehlerbehebung bei der Kommunikation zwischen Knoten * Überprüfung der Fabric-Netzwerkkonfiguration * Diagnose von Cluster-Konnektivitätsproblemen **CLI-Syntax:** ```bash verge fabric show ``` *** ### IP **Zweck:** Erweiterter IP-Befehlszugriff für Diagnose von Schnittstellen und Routing. **Wann verwenden:** * Detaillierte Analyse der Netzwerkschnittstelle * Überprüfung der Routing-Tabelle * Erweiterte Netzwerk-Fehlerbehebung **Parameter:** * **Befehl:** IP-Befehlsoptionen (route, addr, link usw.) **CLI-Syntax:** ```bash ip [BEFEHL] [OPTIONEN] ``` *** ### IPMI BMC-Info **Zweck:** Zeigt Informationen des Baseboard Management Controllers an. **Wann verwenden:** * Fehlerbehebung bei der Hardware-Verwaltung * Überprüfung der IPMI-Konfiguration * Diagnose der Fernverwaltung **CLI-Syntax:** ```bash ipmitool bmc info ``` *** ### IPMI-Chassis-Status **Zweck:** Zeigt den physischen Chassis-Status und Leistungsinformationen an. **Wann verwenden:** * Fehlerbehebung bei der Stromverwaltung * Überprüfung des Hardware-Status * Diagnose des physischen Systems **CLI-Syntax:** ```bash ipmitool chassis status ``` *** ### IPMI FRU-Info **Zweck:** Zeigt Informationen zu Field Replaceable Units aus IPMI an. **Wann verwenden:** * Hardware-Inventarverwaltung * Komponentenidentifizierung * Garantie- und Supportinformationen **CLI-Syntax:** ```bash ipmitool fru print ``` *** ### IPMI LAN-Info **Zweck:** Zeigt Details zur IPMI-Netzwerkkonfiguration an. **Wann verwenden:** * Fehlerbehebung bei IPMI-Netzwerken * Probleme mit der Konnektivität der Fernverwaltung * Überprüfung der BMC-Netzwerkkonfiguration **CLI-Syntax:** ```bash ipmitool lan print ``` *** ### IPMI MC-Reset **Zweck:** Setzt den Management Controller (BMC) zurück. **Wann verwenden:** * Behebung von IPMI-Kommunikationsproblemen * BMC-Fehlerbehebung * Wiederherstellung der Verwaltungsoberfläche {% hint style="warning" %} **Auswirkungen auf die Verwaltung** Dadurch wird die IPMI/BMC-Funktionalität während des Rücksetzens vorübergehend unterbrochen. {% endhint %} **CLI-Syntax:** ```bash ipmitool mc reset cold ``` *** ### IPMI Sensor Data Repository **Zweck:** Zeigt umfassende Informationen aus dem Sensor-Daten-Repository an. **Wann verwenden:** * Detaillierte Hardwareüberwachung * Überprüfung der Sensor-Konfiguration * Hardwarediagnose und -analyse **CLI-Syntax:** ```bash ipmitool sdr list ``` *** ### IPMI-Sensoren **Zweck:** Zeigt aktuelle Sensorwerte (Temperatur, Spannung, Lüfter usw.) an. **Wann verwenden:** * Überwachung des Hardwarezustands * Temperatur- und Leistungsdiagnose * Fehlerbehebung bei Umgebungsproblemen **CLI-Syntax:** ```bash ipmitool sensor list ``` *** ### IPMI-Systemereignisprotokolle **Zweck:** Zeigt Systemereignisprotokolle aus IPMI an. **Wann verwenden:** * Analyse von Hardwarefehlern * Fehlerbehebung bei Systemereignissen * Untersuchung historischer Hardwareprobleme **CLI-Syntax:** ```bash ipmitool sel list ``` *** ### LED-Steuerung (Laufwerk) **Zweck:** Steuert LED-Anzeigen auf Speichermedien zur physischen Identifizierung. **Wann verwenden:** * Physische Laufwerksidentifizierung * Austauschverfahren für Laufwerke * Aufgaben zur Hardwarewartung **Parameter:** * **Laufwerk:** Kennung des Ziel-Laufwerks * **Aktion:** LED an/aus/blinken **CLI-Syntax:** ```bash ledctl locate=[DRIVE_PATH] ``` *** ### Protokolle **Zweck:** Zeigt die Systemprotokolle und Journal-Einträge des Knotens an. **Wann verwenden:** * Systemfehlerbehebung * Fehleranalyse * Untersuchung von Leistungsproblemen **CLI-Syntax:** ```bash journalctl -n 100 dmesg ``` *** ### Netzwerk-Bonding **Zweck:** Zeigt die Konfiguration und den Status des Netzwerk-Bondings an. **Wann verwenden:** * Fehlerbehebung bei der Netzwerk-Redundanz * Diagnose der Bond-Schnittstelle * Überprüfung der Link-Aggregation **CLI-Syntax:** ```bash cat /proc/net/bonding/[BOND_NAME] ``` *** ### OpenSSL-Geschwindigkeit **Zweck:** Testet die kryptografische Leistung der CPU des Knotens. **Wann verwenden:** * Leistungsvergleich * Testen der kryptografischen Fähigkeiten * Überprüfung der Hardwarebeschleunigung **CLI-Syntax:** ```bash openssl speed ``` *** ### Ping **Zweck:** Testet die Netzwerkverbindung vom Knoten aus. **Wann verwenden:** * Test der grundlegenden Konnektivität * Überprüfung des Netzwerkpfads * Messung der Latenz **Parameter:** * **Ziel:** Ziel-IP oder Hostname * **Anzahl:** Anzahl der Ping-Pakete **CLI-Syntax:** ```bash ping -c [ANZAHL] [ZIEL] ``` *** ### RAS-Abfrage **Zweck:** Fragt Informationen zu Zuverlässigkeit, Verfügbarkeit und Wartbarkeit ab. **Wann verwenden:** * Bewertung der Hardwarezuverlässigkeit * Status der Fehlerkorrektur * Speicher- und Prozessor-Diagnose **CLI-Syntax:** ```bash ras-mc-ctl --summary ``` *** ### S.M.A.R.T.-Diagnosetest **Zweck:** Startet SMART-Diagnosetests auf Speichermedien. **Wann verwenden:** * Proaktive Laufwerkszustandsprüfung * Fehlerbehebung beim Speicher * Vorbeugende Wartung **Parameter:** * **Laufwerk:** Ziel-Laufwerk für den Test * **Testtyp:** Kurz-, Lang- oder Übertragungstest **CLI-Syntax:** ```bash smartctl -t [TEST_TYPE] [DRIVE_PATH] ``` {% hint style="info" %} **Testdauer** SMART-Tests können viel Zeit in Anspruch nehmen, insbesondere Langzeittests. {% endhint %} *** ### S.M.A.R.T.-Informationen **Zweck:** Zeigt SMART-Attribute und Gesundheitsinformationen für Laufwerke an. **Wann verwenden:** * Bewertung des Laufwerkszustands * Prädiktive Fehleranalyse * Überwachung der Speicherleistung **Parameter:** * **Laufwerk:** Kennung des Ziel-Laufwerks **CLI-Syntax:** ```bash smartctl -a [DRIVE_PATH] ``` *** ### Blockgeräte anzeigen **Zweck:** Listet alle für den Knoten sichtbaren Blockgeräte auf. **Wann verwenden:** * Inventar der Speichergeräte * Fehlerbehebung bei der Erkennung von Laufwerken * Überprüfung der Speicherkonfiguration **CLI-Syntax:** ```bash lsblk fdisk -l ``` *** ### TCP-Verbindungstest **Zweck:** Testet die TCP-Konnektivität zu Remote-Hosts und Ports. **Wann verwenden:** * Überprüfung der Dienstkonnektivität * Testen von Firewall-Regeln * Netzwerk-Fehlerbehebung **Parameter:** * **Host:** Ziel-Hostname oder IP * **Port:** TCP-Portnummer **CLI-Syntax:** ```bash telnet [HOST] [PORT] nc -zv [HOST] [PORT] ``` *** ### TCP-Dump **Zweck:** Erfasst Netzwerkpakete für eine detaillierte Verkehrsanalyse. **Wann verwenden:** * Netzwerk-Fehlerbehebung * Sicherheitsanalyse * Protokoll-Debugging **Parameter:** * **Schnittstelle:** Zu überwachende Netzwerkschnittstelle * **Filter:** Paketfilter-Ausdruck **CLI-Syntax:** ```bash tcpdump -i [SCHNITTSTELLE] [FILTER] ``` {% hint style="warning" %} **Auswirkungen auf die Leistung** Die Paketerfassung kann die Leistung des Knotens beeinträchtigen. In der Produktion mit Vorsicht verwenden. {% endhint %} *** ### Höchste CPU-Auslastung **Zweck:** Zeigt Prozesse an, die die meisten CPU-Ressourcen verbrauchen. **Wann verwenden:** * Fehlerbehebung bei der Leistung * Analyse der Ressourcenauslastung * Prozessüberwachung **CLI-Syntax:** ```bash top -o %CPU ``` *** ### Höchste Netzwerkauslastung **Zweck:** Zeigt Prozesse mit der höchsten Netzwerkauslastung an. **Wann verwenden:** * Analyse der Netzwerkleistung * Fehlerbehebung bei der Bandbreitenauslastung * Identifizierung netzwerkintensiver Prozesse **CLI-Syntax:** ```bash iftop nethogs ``` *** ### Routenverfolgung **Zweck:** Spürt den Netzwerkpfad vom Knoten zu einem Ziel auf. **Wann verwenden:** * Fehlerbehebung beim Netzwerk-Routing * Pfadanalyse * Diagnose von Verbindungsproblemen **Parameter:** * **Ziel:** Ziel-IP oder Hostname **CLI-Syntax:** ```bash traceroute [ZIEL] mtr [ZIEL] ``` *** ### Meine IP-Adresse **Zweck:** Zeigt die externe IP-Adresse des Knotens an. **Wann verwenden:** * Überprüfung der externen Konnektivität * Fehlerbehebung bei NAT-Konfigurationen * Validierung der Netzwerkkonfiguration **CLI-Syntax:** ```bash curl ifconfig.me ``` ## Bewährte Vorgehensweisen ### Workflow für Hardwarediagnosen 1. **Systemübersicht:** Beginnen Sie mit DMI-Tabelle und IPMI-Chassis-Status 2. **Gesundheitsprüfung:** Überprüfen Sie IPMI-Sensoren und Systemereignisprotokolle 3. **Speicheranalyse:** S.M.A.R.T.-Informationen und Tests verwenden 4. **Netzwerküberprüfung:** Netzwerk-Bonding und Schnittstellenstatus prüfen 5. **Leistungsbewertung:** CPU- und Netzwerkauslastung überwachen ### Vorbeugende Wartung * **Regelmäßige Gesundheitsprüfungen:** IPMI-Sensoren und SMART-Daten überwachen * **Protokollprüfung:** Systemereignisprotokolle regelmäßig prüfen * **Leistungsüberwachung:** Trends bei CPU- und Netzwerkauslastung verfolgen * **Laufwerkszustand:** Regelmäßige SMART-Diagnosetests einplanen ### Sicherheitsaspekte * **Auswirkungsbewertung:** Berücksichtigen Sie die Auswirkungen von Diagnosebefehlen auf Produktionssysteme * **Abstimmung mit dem Support:** Binden Sie den VergeOS-Support bei komplexen Hardwareproblemen ein * **Dokumentation:** Bewahren Sie Aufzeichnungen der Diagnoseergebnisse für die Trendanalyse auf * **Änderungskontrolle:** Befolgen Sie die Change-Management-Verfahren für Hardwareänderungen ## Häufige Probleme des Knotens beheben ### Hardwareprobleme 1. Prüfen Sie **IPMI-Sensoren** für Temperatur-, Spannungs- und Lüfterprobleme 2. Prüfen Sie **IPMI-Systemereignisprotokolle** für Hardwarefehler 3. Verwenden Sie **S.M.A.R.T.-Informationen** zur Beurteilung des Laufwerkszustands ### Netzwerkprobleme 1. Überprüfen Sie **Netzwerk-Bonding** Status und Konfiguration 2. Verwenden Sie **Ethernet-Tool** um die Schnittstelleneinstellungen zu prüfen 3. Konnektivität testen mit **Ping** und **Routenverfolgung** ### Leistungsprobleme 1. Überwachen Sie **Höchste CPU-Auslastung** auf Ressourcenengpässe 2. Prüfen Sie **Höchste Netzwerkauslastung** auf Bandbreitenauslastung 3. Prüfen Sie **Protokolle** auf leistungsbezogene Fehler ### Speicherprobleme 1. Verwenden Sie **Blockgeräte anzeigen** um die Laufwerkerkennung zu überprüfen 2. Ausführen **S.M.A.R.T.-Diagnosetests** für umfassende Laufwerkstests 3. Prüfen Sie **RAS-Abfrage** für Informationen zu Speicher- und Speicherfehlern ## Nächste Schritte Nachdem Sie die Knotendiagnosen beherrschen, können Sie als Nächstes Folgendes erkunden: * Erweiterte Hardwareüberwachung und Alarmierung * Automatisiertes Diagnose-Scripting * Integration mit externen Überwachungssystemen * Planung vorbeugender Wartung Bei komplexen Hardwareproblemen oder ungewöhnlichen Diagnoseergebnissen wenden Sie sich an [VergeOS-Support](/overview/de/support-and-services.md) mit detaillierten Diagnoseausgaben und Systeminformationen. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/run-the-platform/de/systemadministration/node-diagnostics.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.