Seminar Netmaker Fehleranalyse und Troubleshooting

Unspezifische Maßnahmen wie Neustart oder Neuinstallation verdecken häufig die eigentliche Ursache. Das Seminar verwendet ein schichtweises Diagnosemodell, mit dem Beobachtung, Hypothese, Messung, Eingriff und Verifikation sauber getrennt werden.

Inhaltsverzeichnis

1. Zielsetzung
2. Zielgruppe
3. Voraussetzungen
4. Seminarinhalte
5. Praxisübungen

Zielsetzung

Im Mittelpunkt stehen folgende fachliche und praktische Schwerpunkte:

• Störungen nach Steuerungsebene, Tunnel, Routing, Namensauflösung und Anwendungspfad klassifizieren.
• Netclient-, WireGuard-, System- und Serverinformationen gezielt erheben und korrelieren.
• NAT-, Firewall-, MTU-, Gateway-, Relay- und Egress-Probleme reproduzierbar eingrenzen.
• Diagnoseschritte, Eskalationsdaten und dauerhafte Korrekturen in Runbooks dokumentieren.

Zielgruppe

Netmaker-Administration, Netzwerkbetrieb, Linux- und Cloud-Betrieb, Service Desk der höheren Supportstufen und technische Einsatzleitung

Voraussetzungen

Praktische Netmaker-Erfahrung, Linux-Kommandozeile sowie Kenntnisse zu IP-Routing, NAT, DNS und WireGuard

Seminarinhalte

Modul 1: Diagnosemodell und Beweissicherung

Jede Störung wird mit Zeitlinie, Sollzustand, Reichweite und reproduzierbarem Test beschrieben.

1. Schritt 1: Betroffene Netze, Knoten, Benutzer, Ziele und Zeitpunkt erfassen.
2. Schritt 2: Letzte Änderungen und bekannte Abhängigkeiten sichern.
3. Schritt 3: Einen minimalen Positiv- und Negativtest definieren, bevor Änderungen erfolgen.

Modul 2: Server- und Steuerungsebene

Konfigurationsverteilung und administrative Erreichbarkeit werden getrennt vom Datenpfad geprüft.

1. Schritt 1: Serverdienste, Zertifikate, DNS, Message Queue und Datenhaltung auf Zustand prüfen.
2. Schritt 2: Client-Synchronisation und Aktualität der Objektkonfiguration vergleichen.
3. Schritt 3: Serverlogs zeitlich mit Änderungen und Clientmeldungen korrelieren.

Modul 3: Netclient und WireGuard

Installation, Dienstzustand, Peers und Handshakes bilden die Basis der Endpunktdiagnose.

1. Schritt 1: Netclient-Version, Dienststatus, Serverzuordnung und Netzmitgliedschaft prüfen.
2. Schritt 2: WireGuard-Interface, Peers, letzte Handshakes und Zähler auswerten.
3. Schritt 3: Konfiguration synchronisieren und nur bei nachgewiesener Beschädigung neu installieren.

Modul 4: Routing, AllowedIPs und Firewall

Ein vorhandener Handshake beweist noch keinen funktionierenden Anwendungspfad.

1. Schritt 1: Routingtabellen und WireGuard AllowedIPs gegen das Sollmodell vergleichen.
2. Schritt 2: Paketpfad mit Ping, Traceroute und Porttest schrittweise verfolgen.
3. Schritt 3: Host-, Cloud- und Standortfirewalls sowie Forwarding-Regeln entlang des Pfads kontrollieren.

Modul 5: NAT, Endpoint und MTU

Restriktive Netze erzeugen typische Symptome wie instabile Handshakes oder einseitigen Verkehr.

1. Schritt 1: Öffentliche und erkannte Endpoints sowie statische Ports auf Plausibilität prüfen.
2. Schritt 2: NAT-Zeitüberschreitung, Keepalive, Portweiterleitung und Relay-Bedarf bewerten.
3. Schritt 3: MTU mit schrittweisen Paketgrößentests bestimmen und kontrolliert anpassen.

Modul 6: DNS, Gateways, Relays und Egress

Komplexe Pfade werden in einzelne Übergänge zerlegt.

1. Schritt 1: DNS-Anfrage, Resolverroute und Antwortpfad getrennt testen.
2. Schritt 2: Gateway-Zuordnung, Auto-Relay, IP-Forwarding und Transitregeln prüfen.
3. Schritt 3: Egress-Ziele, NAT, ACLs, Rückroute und überlappende Netze gegeneinander validieren.

Praxisübungen

• Fehlerbild ohne Peer-Synchronisation trotz erreichbarem Server.
• WireGuard-Handshake vorhanden, Anwendung wegen Route oder MTU dennoch nicht erreichbar.
• Relay-Pfad mit fehlendem IP-Forwarding und blockierender Firewallregel.
• Egress-Störung durch überlappende Route, falsches NAT und nicht erreichbaren DNS-Resolver.