> 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

Umfassende Referenz für VergeOS-Knotendiagnosetools, einschließlich IPMI-Befehlen, SMART-Tests, Netzwerkdiagnose, Fabric-Konfiguration und Hardware-Fehlerbehebung.

## Übersicht

Das Tool zur Knotendiagnose bietet umfassende Funktionen zur Fehlerbehebung auf Hardware- und Systemebene für einzelne VergeOS-Knoten. Mit diesen Diagnosebefehlen können Systemadministratoren detaillierte Hardwareanalysen durchführen, die Systemleistung überwachen und knotenspezifische Probleme direkt über die VergeOS-Oberfläche beheben.

{% hint style="info" %}
**Das lernen Sie**

* So greifen Sie auf die Knotendiagnosetools zu und verwenden sie
* Die einzelnen Diagnosebefehle und ihre jeweiligen Hardware-Schwerpunkte verstehen
* Bewährte Verfahren zur Fehlerbehebung auf Knotenebene
* Wann bestimmte Diagnosebefehle bei Hardwareproblemen eingesetzt werden sollten
  {% endhint %}

## Voraussetzungen

* Zugriff auf die VergeOS-Oberfläche mit Berechtigungen zur Knotenverwaltung
* Grundlegende Kenntnisse der Serverhardwarekomponenten
* Kenntnisse von Netzwerk- und Speicherkonzepten

{% hint style="info" %}
**Knotenzugriff**

Die Knotendiagnose ermöglicht weitreichenden Zugriff auf Hardwareebene und sollte von erfahrenen Systemadministratoren verwendet werden.
{% endhint %}

## Knotendiagnose aufrufen

1. **Zur Knotendiagnose navigieren:**
   * Wählen Sie **Infrastruktur** > **Knoten** im oberen Menü aus.
   * Wählen Sie den gewünschten **Knoten** aus der Liste aus
   * Klicken Sie auf **Diagnose** im linken Menü
2. **Diagnosebefehle verwenden:**
   * Wählen Sie den gewünschten Befehl aus dem Dropdown-Menü **Abfrage** aus
   * Konfigurieren Sie die verfügbaren Parameter auf der rechten Seite
   * Klicken Sie auf **Senden →** um den Befehl auszuführen

{% hint style="success" %}
**Befehlsanzeige**

Aktivieren Sie **„Befehl anzeigen“** um den genauen Befehl anzuzeigen, der ausgeführt wird. Dies ist für die Ausführung über SSH oder die Automatisierung per Skript nützlich.
{% endhint %}

## Referenz der Diagnosebefehle

### ARP-Scan

**Zweck:** Ermittelt mithilfe von ARP-Paketen aktive Geräte an den Netzwerkschnittstellen des Knotens.

**Anwendungsfälle:**

* Ü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, über die der Scan durchgeführt wird

**CLI-Syntax:**

```bash
nmap -sn [NETWORK_RANGE]
```

***

### ARP-Tabelle

**Zweck:** Zeigt den ARP-Cache des Knotens mit Zuordnungen von IP- zu MAC-Adressen an.

**Anwendungsfälle:**

* Behebung von Problemen mit der Netzwerkverbindung des Knotens
* Überprüfung der Erkennung von Netzwerkpartnern
* Prüfen, ob ARP-Konflikte den Knoten beeinträchtigen

**CLI-Syntax:**

```bash
arp -a
```

***

### Bridge-Adressen

**Zweck:** Zeigt die MAC-Adresstabellen der Netzwerk-Bridges auf dem Knoten an.

**Anwendungsfälle:**

* Behebung von Problemen mit der Konfiguration von Netzwerk-Bridges
* Überprüfung des MAC-Lernverhaltens auf virtuellen Switches
* Analyse der Netzwerktopologie

**CLI-Syntax:**

```bash
brctl showmacs [BRIDGE_NAME]
```

***

### Persistenten Speicher leeren

**Zweck:** Leert die Caches des persistenten Speichers und temporäre Daten auf dem Knoten.

**Anwendungsfälle:**

* Behebung von leistungsbezogenen Speicherproblemen
* Beschädigte Cache-Daten löschen
* Vorbereitung einer Neukonfiguration des Speichers

{% hint style="danger" %}
**Warnung zu den Auswirkungen auf Daten**

Dieser Befehl kann die Systemleistung beeinträchtigen und sollte nur auf Anweisung des Supports verwendet werden.
{% endhint %}

**CLI-Syntax:**

```bash
sync && echo 3 > /proc/sys/vm/drop_caches
```

***

### DMI-Tabelle

**Zweck:** Zeigt Informationen zur Desktop Management Interface (DMI) an, einschließlich Hardwaredetails.

**Anwendungsfälle:**

* Hardwareinventar und -identifikation
* Überprüfung der Systemspezifikationen
* Behebung von Problemen mit der Hardwarekompatibilität

**CLI-Syntax:**

```bash
dmidecode
```

***

### DNS-Abfrage

**Zweck:** Testet die DNS-Auflösung aus Sicht des Knotens.

**Anwendungsfälle:**

* Behebung von Problemen mit der DNS-Konfiguration des Knotens
* Überprüfung der externen Konnektivität des Knotens
* Testen von Namensauflösungsdiensten

**Parameter:**

* **Hostname:** Aufzulösender Zielhostname
* **DNS-Server:** Abzufragender spezifischer DNS-Server

**CLI-Syntax:**

```bash
nslookup [HOSTNAME]
dig [HOSTNAME]
```

***

### Ethernet-Tool

**Zweck:** Stellt detaillierte Informationen und Konfigurationsangaben zu Ethernet-Schnittstellen bereit.

**Anwendungsfälle:**

* Diagnose von Problemen mit Netzwerkschnittstellen
* Überprüfung der Verbindungsgeschwindigkeit und Duplexeinstellungen
* Behebung von Problemen mit der physischen Netzwerkverbindung

**Parameter:**

* **Schnittstelle:** Zu untersuchende Netzwerkschnittstelle

**CLI-Syntax:**

```bash
ethtool [INTERFACE]
```

***

### Fabric-Konfiguration

**Zweck:** Zeigt die VergeOS-Fabric-Netzwerkkonfiguration für den Knoten an.

**Anwendungsfälle:**

* Fehlerbehebung bei der Kommunikation zwischen Knoten
* Überprüfen der Fabric-Netzwerkeinrichtung
* Diagnose von Problemen mit der Clusterverbindung

**CLI-Syntax:**

```bash
verge fabric show
```

***

### IP

**Zweck:** Erweiterter Zugriff auf IP-Befehle zur Diagnose von Schnittstellen und Routing.

**Anwendungsfälle:**

* Detaillierte Analyse der Netzwerkschnittstellen
* Untersuchung der Routingtabelle
* Erweiterte Netzwerkfehlerbehebung

**Parameter:**

* **Befehl:** Optionen des IP-Befehls (route, addr, link usw.)

**CLI-Syntax:**

```bash
ip [COMMAND] [OPTIONS]
```

***

### IPMI-BMC-Informationen

**Zweck:** Zeigt Informationen zum Baseboard Management Controller an.

**Anwendungsfälle:**

* Fehlerbehebung bei der Hardwareverwaltung
* Überprüfen der IPMI-Konfiguration
* Diagnose der Fernverwaltung

**CLI-Syntax:**

```bash
ipmitool bmc info
```

***

### IPMI-Gehäusestatus

**Zweck:** Zeigt den Status des physischen Gehäuses und Informationen zur Stromversorgung an.

**Anwendungsfälle:**

* Fehlerbehebung bei der Energieverwaltung
* Überprüfen des Hardwarestatus
* Diagnose des physischen Systems

**CLI-Syntax:**

```bash
ipmitool chassis status
```

***

### IPMI-FRU-Informationen

**Zweck:** Zeigt Informationen zu austauschbaren Einheiten (FRU) von IPMI an.

**Anwendungsfälle:**

* Verwaltung des Hardwareinventars
* Identifizierung von Komponenten
* Garantie- und Supportinformationen

**CLI-Syntax:**

```bash
ipmitool fru print
```

***

### IPMI-LAN-Informationen

**Zweck:** Zeigt Details zur IPMI-Netzwerkkonfiguration an.

**Anwendungsfälle:**

* Fehlerbehebung beim IPMI-Netzwerk
* Probleme mit der Fernverwaltungsverbindung
* Überprüfen der BMC-Netzwerkkonfiguration

**CLI-Syntax:**

```bash
ipmitool lan print
```

***

### IPMI-MC-Reset

**Zweck:** Setzt den Management Controller (BMC) zurück.

**Anwendungsfälle:**

* Beheben von Problemen mit der IPMI-Kommunikation
* BMC-Fehlerbehebung
* Wiederherstellung der Management-Schnittstelle

{% hint style="warning" %}
**Auswirkungen auf das Management**

Während des Zurücksetzens wird die IPMI-/BMC-Funktionalität vorübergehend unterbrochen.
{% endhint %}

**CLI-Syntax:**

```bash
ipmitool mc reset cold
```

***

### IPMI-Sensordaten-Repository

**Zweck:** Zeigt umfassende Informationen zum Sensordaten-Repository an.

**Anwendungsfälle:**

* Detaillierte Hardwareüberwachung
* Überprüfung der Sensorkonfiguration
* Hardwarediagnose und -analyse

**CLI-Syntax:**

```bash
ipmitool sdr list
```

***

### IPMI-Sensoren

**Zweck:** Zeigt aktuelle Sensorwerte an (Temperatur, Spannung, Lüfter usw.).

**Anwendungsfälle:**

* Überwachung des Hardwarezustands
* Temperatur- und Leistungsdiagnose
* Fehlersuche bei Umgebungsbedingungen

**CLI-Syntax:**

```bash
ipmitool sensor list
```

***

### IPMI-Systemereignisprotokolle

**Zweck:** Zeigt Systemereignisprotokolle von IPMI an.

**Anwendungsfälle:**

* Analyse von Hardwarefehlern
* Fehlersuche bei Systemereignissen
* Untersuchung früherer Hardwareprobleme

**CLI-Syntax:**

```bash
ipmitool sel list
```

***

### LED-Steuerung (Laufwerk)

**Zweck:** Steuert LED-Anzeigen an Speicherlaufwerken zur physischen Identifizierung.

**Anwendungsfälle:**

* Physische Laufwerksidentifizierung
* Verfahren zum Austausch von Laufwerken
* Hardwarewartungsaufgaben

**Parameter:**

* **Laufwerk:** Kennung des Ziellaufwerks
* **Aktion:** LED ein/aus/blinken

**CLI-Syntax:**

```bash
ledctl locate=[DRIVE_PATH]
```

***

### Protokolle

**Zweck:** Zeigt Systemprotokolle und Journaleinträge des Knotens an.

**Anwendungsfälle:**

* Systemfehlersuche
* Fehleranalyse
* Untersuchung von Leistungsproblemen

**CLI-Syntax:**

```bash
journalctl -n 100
dmesg
```

***

### Netzwerk-Bonding

**Zweck:** Zeigt die Konfiguration und den Status des Netzwerk-Bondings an.

**Anwendungsfälle:**

* Fehlersuche bei Netzwerkredundanz
* Diagnose der Bond-Schnittstelle
* Überprüfung der Link-Aggregation

**CLI-Syntax:**

```bash
cat /proc/net/bonding/[BOND_NAME]
```

***

### OpenSSL-Geschwindigkeitstest

**Zweck:** Testet die kryptografische Leistung der CPU des Knotens.

**Anwendungsfälle:**

* Leistungsbenchmarking
* Test der kryptografischen Fähigkeiten
* Überprüfung der Hardwarebeschleunigung

**CLI-Syntax:**

```bash
openssl speed
```

***

### Ping

**Zweck:** Testet die Netzwerkverbindung vom Knoten aus.

**Anwendungsfälle:**

* Test der grundlegenden Konnektivität
* Überprüfung des Netzwerkpfads
* Latenzmessung

**Parameter:**

* **Ziel:** Ziel-IP-Adresse oder Hostname
* **Anzahl:** Anzahl der Ping-Pakete

**CLI-Syntax:**

```bash
ping -c [COUNT] [DESTINATION]
```

***

### RAS-Abfrage

**Zweck:** Fragt Informationen zu Zuverlässigkeit, Verfügbarkeit und Wartungsfreundlichkeit ab.

**Anwendungsfälle:**

* Bewertung der Hardwarezuverlässigkeit
* Status der Fehlerkorrektur
* Speicher- und Prozessordiagnose

**CLI-Syntax:**

```bash
ras-mc-ctl --summary
```

***

### S.M.A.R.T.-Diagnosetest

**Zweck:** Startet SMART-Diagnosetests auf Speicherlaufwerken.

**Anwendungsfälle:**

* Proaktive Prüfung des Laufwerkszustands
* Fehlerbehebung bei Speicherproblemen
* Vorbeugende Wartung

**Parameter:**

* **Laufwerk:** Ziellaufwerk für den Test
* **Testtyp:** Kurzer, langer oder Transporttest

**CLI-Syntax:**

```bash
smartctl -t [TEST_TYPE] [DRIVE_PATH]
```

{% hint style="info" %}
**Testdauer**

SMART-Tests können viel Zeit in Anspruch nehmen, insbesondere lange Tests.
{% endhint %}

***

### S.M.A.R.T.-Informationen

**Zweck:** Zeigt SMART-Attribute und Zustandsinformationen für Laufwerke an.

**Anwendungsfälle:**

* Bewertung des Laufwerkszustands
* Vorausschauende Fehleranalyse
* Überwachung der Speicherleistung

**Parameter:**

* **Laufwerk:** Kennung des Ziellaufwerks

**CLI-Syntax:**

```bash
smartctl -a [DRIVE_PATH]
```

***

### Blockgeräte anzeigen

**Zweck:** Listet alle für den Knoten sichtbaren Blockgeräte auf.

**Anwendungsfälle:**

* Bestandsaufnahme der Speichergeräte
* Fehlerbehebung bei der Laufwerkserkennung
* Überprüfung der Speicherkonfiguration

**CLI-Syntax:**

```bash
lsblk
fdisk -l
```

***

### TCP-Verbindungstest

**Zweck:** Testet die TCP-Konnektivität zu Remote-Hosts und Ports.

**Anwendungsfälle:**

* Überprüfung der Dienstkonnektivität
* Testen von Firewallregeln
* Netzwerkfehlerbehebung

**Parameter:**

* **Host:** Zielhostname oder IP-Adresse
* **Port:** TCP-Portnummer

**CLI-Syntax:**

```bash
telnet [HOST] [PORT]
nc -zv [HOST] [PORT]
```

***

### TCP-Dump

**Zweck:** Erfasst Netzwerkpakete zur detaillierten Analyse des Datenverkehrs.

**Anwendungsfälle:**

* Netzwerkfehlerbehebung
* Sicherheitsanalyse
* Protokoll-Debugging

**Parameter:**

* **Anzahl der Pakete:** Zu erfassende Pakete (100 bis 1000, Standardwert: 100)
* **Zeitüberschreitung in Sekunden:** Erfassungsdauer (1 bis 30, Standardwert: 15)
* **Schnittstellentyp:** ***Physisch***, ***VXLAN***, ***Bridges***, oder ***TAP-Geräte***
* **Name:** Die Schnittstelle, auf der die Erfassung erfolgen soll, gefiltert nach **Schnittstellentyp**.
* **Ausführlichkeit der Ausgabe:** ***Keine***, ***Niedrig***, ***Mittel***, oder ***Hoch***
* **Link-Layer-Header anzeigen (VLAN, MAC):** Fügt `-e` zum Befehl hinzu, sodass jedes Paket seine MAC-Adressen und sein 802.1Q-VLAN-Tag anzeigt
* **Ausdruck:** Pakete-Filterausdruck (zum Beispiel `vlan 210` oder `not vlan 1`), der unverändert an den Befehl angehängt wird

{% hint style="info" %}
**Liste der Schnittstellennamen**

Die **physische** Liste zeigt die physischen NICs des Knotens. **Bridges** und **TAP-Geräte** zeigen nur Bridges und TAP-Geräte für Netzwerke und VMs an, die auf dem ausgewählten Knoten laufen. Führen Sie die Erfassung daher auf dem Knoten aus, auf dem das Netzwerk oder die VM läuft.
{% endhint %}

{% hint style="info" %}
**VLAN-Tags anzeigen**

Standardmäßig gibt die Erfassung keine Sicherungsschicht-Header aus. Daher erscheinen VLAN-markierte Frames als gewöhnlicher IP-Verkehr ohne VLAN-ID. Aktivieren Sie **Sicherungsschicht-Header anzeigen (VLAN, MAC)** um Tags zu sehen, zum Beispiel `ethertype 802.1Q (0x8100) ... vlan 210, p 0`.
{% endhint %}

**CLI-Syntax:**

Aktivieren Sie **Befehl anzeigen** um den genau verwendeten Befehl zu sehen. Der Standardbefehl lautet:

```bash
busybox timeout 15 tcpdump -lni [INTERFACE] -c 100
```

Wenn **Sicherungsschicht-Header anzeigen (VLAN, MAC)** aktiviert ist und ein **Ausdruck** eingegeben wurde:

```bash
busybox timeout 15 tcpdump -lni [INTERFACE] -c 100 -e [EXPRESSION]
```

{% hint style="warning" %}
**Auswirkungen auf die Leistung**

Die Paketerfassung kann die Leistung des Knotens beeinträchtigen. Verwenden Sie sie in Produktionsumgebungen mit Bedacht.
{% endhint %}

***

### Höchste CPU-Auslastung

**Zweck:** Zeigt die Prozesse an, die die meisten CPU-Ressourcen verbrauchen.

**Anwendungsfälle:**

* Fehlersuche bei Leistungsproblemen
* Analyse der Ressourcenauslastung
* Prozessüberwachung

**CLI-Syntax:**

```bash
top -o %CPU
```

***

### Höchste Netzwerkauslastung

**Zweck:** Zeigt Prozesse mit der höchsten Netzwerkauslastung an.

**Anwendungsfälle:**

* Analyse der Netzwerkleistung
* Fehlersuche bei der Bandbreitenauslastung
* Ermittlung netzwerkintensiver Prozesse

**CLI-Syntax:**

```bash
iftop
nethogs
```

***

### Route verfolgen

**Zweck:** Verfolgt den Netzwerkpfad vom Knoten zu einem Ziel.

**Anwendungsfälle:**

* Fehlersuche beim Netzwerk-Routing
* Pfadanalyse
* Diagnose von Verbindungsproblemen

**Parameter:**

* **Ziel:** Ziel-IP-Adresse oder Hostname

**CLI-Syntax:**

```bash
traceroute [DESTINATION]
mtr [DESTINATION]
```

***

### Wie lautet meine IP-Adresse?

**Zweck:** Zeigt die externe IP-Adresse des Knotens an.

**Anwendungsfälle:**

* Überprüfung der externen Konnektivität
* Fehlerbehebung bei der NAT-Konfiguration
* Validierung der Netzwerkkonfiguration

**CLI-Syntax:**

```bash
curl ifconfig.me
```

## Bewährte Vorgehensweisen

### Workflow für die Hardwarediagnose

1. **Systemübersicht:** Beginnen Sie mit der DMI-Tabelle und dem IPMI-Gehäusestatus
2. **Zustandsprüfung:** Überprüfen Sie die IPMI-Sensoren und Systemereignisprotokolle
3. **Speicheranalyse:** Verwenden Sie S.M.A.R.T.-Informationen und -Tests
4. **Netzwerküberprüfung:** Prüfen Sie die Netzwerkbündelung und den Schnittstellenstatus
5. **Leistungsbewertung:** Überwachen Sie die CPU- und Netzwerkauslastung

### Vorbeugende Wartung

* **Regelmäßige Zustandsprüfungen:** Überwachen Sie IPMI-Sensoren und SMART-Daten
* **Protokollüberprüfung:** Überprüfen Sie regelmäßig die Systemereignisprotokolle
* **Leistungsüberwachung:** Verfolgen Sie Trends bei der CPU- und Netzwerkauslastung
* **Laufwerkszustand:** Planen Sie regelmäßige diagnostische SMART-Tests

### Sicherheitsaspekte

* **Auswirkungsbewertung:** Berücksichtigen Sie die Auswirkungen diagnostischer Befehle auf Produktionssysteme
* **Support-Koordination:** Ziehen Sie den VergeOS-Support bei komplexen Hardwareproblemen hinzu
* **Dokumentation:** Dokumentieren Sie die Diagnoseergebnisse, um Trends analysieren zu können
* **Änderungssteuerung:** Befolgen Sie bei Hardwareänderungen die Verfahren des Änderungsmanagements

## Fehlerbehebung bei häufigen Knotenproblemen

### Hardwareprobleme

1. Prüfen Sie **IPMI-Sensoren** auf Probleme mit Temperatur, Spannung und Lüftern
2. Überprüfen Sie **IPMI-Systemereignisprotokolle** auf Hardwarefehler
3. Verwenden Sie **S.M.A.R.T.-Informationen** zur Beurteilung des Laufwerkszustands

### Netzwerkprobleme

1. Überprüfen Sie **die Netzwerkbündelung** hinsichtlich Status und Konfiguration
2. Verwenden Sie **das Ethernet-Tool** um Schnittstelleneinstellungen zu überprüfen
3. Testen Sie die Konnektivität mit **Ping** und **Traceroute**

### Leistungsprobleme

1. Überwachen Sie **die höchste CPU-Auslastung** um Ressourcenengpässe zu erkennen
2. Überprüfen Sie **die höchste Netzwerkauslastung** um die Bandbreitenauslastung zu ermitteln
3. Prüfen Sie **die Protokolle** auf leistungsbezogene Fehler

### Speicherprobleme

1. Verwenden Sie **Blockgeräte anzeigen** um zu überprüfen, ob die Laufwerke erkannt werden
2. Führen Sie **S.M.A.R.T.-Diagnosetests** für eine umfassende Laufwerksprüfung aus
3. Überprüfen Sie **RAS-Abfrage** auf Informationen zu Speicher- und Laufwerksfehlern

## Nächste Schritte

Nachdem Sie sich mit der Knotendiagnose vertraut gemacht haben, können Sie sich mit folgenden Themen befassen:

* Erweiterte Hardwareüberwachung und Alarmierung
* Automatisierte Diagnoseskripte
* Integration in externe Überwachungssysteme
* Planung vorbeugender Wartungsmaßnahmen

Wenden Sie sich bei komplexen Hardwareproblemen oder ungewöhnlichen Diagnoseergebnissen an den [VergeOS-Support](https://docs.verge.io/overview/de/support-and-services.md) und übermitteln Sie detaillierte 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verge.io/run-the-platform/de/systemadministration/node-diagnostics.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
