Netzwerk Troubleshooting¶

Grundlegende Checkliste¶

• Der Netzwerkswitch stellt PoE nach Standard IEEE 802.3af (max. 15,4 W / 48 V) zur Verfügung
• Es gibt keinen "Eingriff" in den Paketfluss (z.B. Firewalls, Gateways, Router)
• Es gibt kein Bandbreitenlimit oder Bottleneck im Netzwerk
• Green-GO Traffic ist isoliert von anderen Systemen (VLAN oder Physisch)
• Sollten mehrere Konfigurationen im gleichen Netzwerk aktiv sein, darf die Multicast Adresse nicht für mehrere Konfigurationen verwendet werden.
• Bei hohem Paketvorkommen sollte QoS konfiguriert sein (DSCP: 46)
• Der Multicast Traffic des Green-GO Systems kommt überall ohne Jitter an (Wireshark, Multicast Tester, GGO-MTA)

Häufige Probleme¶

Software¶

Geräte werden nicht automatisch in der Software angezeigt¶

Sollten Green-GO Geräte nicht automatisch in der Connection View der Software erscheinen kann ein manueller Netzwerkscan durchgeführt werden.

Tauchen die Geräte nach diesem Scan mit dem Status Boot Mode oder Unreachable auf, sollte folgendes überprüft werden:

• Die betroffenen Green-GO Geräte benutzen eine v5 Firmware.
• Netzwerkkonfiguration aller Geräte und Computer ist untereinander kompatibel und ermöglicht eine lokale Kommunikation.
• Der Rechner ermpfängt Multicast Traffic auf UDP Port 5810.
  Dies kann u.a. mit Tools wie Wireshark, dem Multicast Tester von DQ Networks, oder der Python Terminal Applikation GGO-MTA überprüft werden.

Geräte werden überhaupt nicht angezeigt¶

Sollte die Software auch nach einem manuellen Netzwerkscan keine Geräte anzeigen, dann ist davon auszugehen, dass keine Kommunikation mit dem Netzwerk möglich ist.

• Es gibt keine Firewall welche die Verbindung der Software blockiert.
• Die Konfiguration der Netzwerkschnittstelle ist korrekt und erlaubt eine Kommunikation mit dem Green-GO System.
• Die Ports 6464 und 5810 werden von keiner Anwendung auf dem Rechner blockiert.

Einzelne Fimware Updates schlagen fehl¶

Es kann leider immer mal wieder vorkommen, das ein Firmwareupdate fehlschlägt. In manchen Fällen gibt die Software zu früh auf, nachdem das Gerät in den Boot Mode neugestartet wurde. Das Gerät ist noch nicht verfügbar und wartet z.B. noch auf eine IP-Adresse.

In einem solchen Fall kann folgender Workaround helfen:

1. Das betroffene Gerät einfach mit Hilfe des Remove Offline Devices Buttons aus der Software entfernt werden.
2. Anschließend muss ein manueller Scan durch einen Klick auf den Update Button und die folgende Scan Option erfolgen.
3. Das Gerät sollte nun mit dem Status Boot Mode erscheinen. Das Firmwareupdate läuft nun in der Regel problemlos wie gewohnt durch.

Geräte ändern Ihren Status immer wieder auf "Lost"¶

Dies ist in der Regel der Fall wenn es Unterbrechungen im Paketfluss kommt. Die Software fragt den Status aller Geräte regelmäßig ab und erwartet ein Paket als Antwort.

Da Green-GO für diese Kommunikation ausschließlich UDP Pakete benutzt, kann eine Zustellung leider nicht garantiert werden und ist stark abhängig von der eingesetzten Netzwerkinfrastruktur.

Eine häufige Ursache für einen "flackernden" Status ist ein Problem mit dem Empfang von Multicast-Traffic der Green-GO Geräte. Dies kann z.B. durch eine drahtlose WLAN Verbindung passieren, eine solche drahtlose Verbindung kann abhängig vom AP und der Konfiguration den Multicast-Datenverkehr "verschlucken".

Geräte¶

Statusindikatoren blinken rot/blau ¶

Sollten die Statusindikatoren eines Geräts rot/blau blinken ist in der Regel kein weiteres Green-GO Gerät mit gleicher Konfiguration im lokalen Netzwerk vorhanden. Alternativ ist es möglich, dass die Kommunikation zu anderen Green-GO Geräten durch die Netzwerkinfrastruktur blockiert ist.

In einem solchen Falle sollte folgendes geprüft werden:

• Alle Geräte haben eine korrekte Netzwerkkonfiguration und kommunizieren im gleichen lokalen Netwerk.
• Alle Geräte benutzen eine Konfiguration mit gleicher Konfigurations ID.
  (Setup Menü → Info → Config → ID: XXXX)
• Die Geräte sind in der Lage sich gegenseitig zu Pingen
  (Setup Menü → Info → IP → Ping)

Audio oder Sprache wird abgehackt oder verändert übertragen¶

Da Green-GO UDP Multicast für die Kommunikation benutzt muss, der Netzwerkverkehr "non-blocking" und ohne Verzögerungen von der Netzwerk-Infrastruktur durchgeleitet werden.

Unterbrochenes bzw. veränderte Audiosignale werden in der Regel dann produziert, wenn die Paketreihenfolge zu stark abweicht, oder der Jitter einer Verbindung zu hoch ist. In einem solchen Falle kann das Green-GO Audio-Codec Artefakte im Audio produzieren.

Eine weitere Ursache für dieses Problem kann auch ein (zu hoher) Paketverlust bei der Kommunikation mit der Multicast-Adresse der Systemkonfiguration sein.

Für eine weiterführende Analyse kann u.a. das Programm Wireshark benutzt werden.

Netzwerk Analyse¶

Für eine vollständige Analyse kann es erforderlich sein den Paketfluss eines spezifischen Switchports zu überwachen. Dies ermöglicht eine direkte Sicht auf den Datenverkehr eines problembehafteten Gerät.

Ein solcher Mittschnitt kann zum Beispiel mit Hilfe einer sogenannten Network TAP erzeugt werden:

Alternativ kann auch der Datenverkehr eines bestimten Switchports auf einen mit dem Rechner verbundenen Switchport dupliziert werden. Diese Funktionalität ist abhängig vom Switchmodel und erfordert eine Anpassung der Switchkonfiguration.

Wireshark¶

• Link: wireshark.org
• Einfärbungsregeln: Download

Wireshark kann hilfreich sein um Netzwerkprobleme in einem System zu analysieren. Das Programm ermöglicht einen schnellen Überblick über generelle "Erreichbarkeiten", Latenzprobleme aber auch tiefer gehende Analysen.

Konfiguration¶

Damit Wireshark optimal funktioniert sollten ein paar Einstellungen überprüft und gegebenenfalls vorgenommen werden:

Promiskuitiver ModusAnzeige und SpaltenGreen-GO Pakete Einfärben

Diese Einstellung ist abhängig vom Treiber des Netzwerk Interfaces und ist möglicherweise nicht immer verfügbar.

Sofern dieser Modus verfügbar ist, sollte dieser unbedingt aktiviert sein. Wenn aktiv, wird das Interface beim Start eines Mittschnitts korrekt initialisiert und Pakete welche nicht an dieses adressiert sind können mitgeschnitten werden.

Wireshark ist ein mächtiges Werkzeug welches für eine tiefergende Analyse umfangreich konfiguriert werden kann. Für den Anfang kann es hilfreich sein folgende Einstellungen vorzunehmen:

ZeitanzeigeDelta Timing Spalte

Um Ereignisse besser im Mittschnitt identifizieren zu können, kann es hilfreich sein die Zeitanzeige der Pakete auf Uhrzeit (01:02:03.123456) zu stellen (Ansicht → Zeitanzeige → Uhrzeit).

Um die Latenz zwischen angezeigten (gefilterten) Paketen besser im Überblick behalten zu können, kann es helfen eine zusätzliche Spalte für diese Berechnung anzulegen:

Wichtig ist hier, dass als Spaltentyp Delta time displayed ausgewählt wird.

Es kann hilfreich sein die Green-GO Pakete mit Hilfe von Farbfiltern einzufärben um Probleme besser zu visualisieren. Die zum Download stehenden Einfärbungsregeln können einfach importiert und verwendet werden:

Datenverkehr Filtern¶

Es können verschiedene Filtermechanismen verwendet werden um die Menge an Paketen zu begrenzen und für eine bessere Übersicht zu sorgen.

Green-GO MTA¶

Link: github.com/lampensau/ggo-mta

Eine Python (3.x) Terminal Applikation welche Verbindungsstatistiken zu Green-GO Konfigurations Subscribern (Geräte) aufführt.

Die Applikation kann mit folgendem Befehl gestartet werden:

python3 ggo-mta.py <multicast-address> <interface-address>

Installation der Vorraussetzungen¶

Damit diese Applikation funktionieren kann, müssen Python 3 und der Paketmanager pip lokal installiert sein.

Python 3 & Pip¶

Eine existierende Installation kann wie folgt über ein Terminalfenster verifiziert werden:

$ python3 --version
Python 3.11.4

$ pip3 --version
pip 23.2.1 from /path/to/python-pip/executable

Muss eines von beiden Installiert werden, kann dies wie folgt geschehen:

sudo apt update && sudo apt install python3 python3-pip python3-setuptools

brew install python3

Andere Vorraussetzungen¶

Die Applikation benötigt die folgenden Python Pakete welche mit pip installiert werden können:

sudo pip3 install --upgrade curses

sudo pip3 install --upgrade curses

sudo pip3 install --upgrade windows-curses