# Troubleshooting

Falls ein Edge Device in der ENLYZE App als offline angezeigt wird oder keine Verbindung bei der initialen Integration hergestellt werden kann, hilft dir die folgende Seite, schnell die Ursache zu finden und zu beheben.

{% hint style="warning" %}
Ab Werk ist die Netzwerkkommunikation eines Edge Devices eingeschränkt. Jedes Edge Device kann mit anderen Netzwerkteilnehmern kommunizieren, falls diese

* sich im selben Netzwerk wie eines der Netzwerkinterfaces des Edge Devices befinden
* über ein Gateway Zugriff auf das `Internet (eth0)` Netzwerk des Edge Devices haben

Um aus anderen Netzwerken auf das Edge Device zuzugreifen, muss eine manuelle Route eingerichtet werden. Erfahre [hier](https://docs.enlyze.com/connect/edge-device/enlyze-edge/routen-einrichten) wie du Routen einrichten kannst.
{% endhint %}

## **Ausschlusskriterien:**

Vor dem Troubleshooting über ENLYZE EDGE, überprüfe bitte folgende Punkte:

* [ ] **Ist das Edge Device mit Strom versorgt?**\
  → Das Edge Device ist mit Strom versorgt, wenn **vorne links eine grüne LED** dauerhaft leuchtet.
* [ ] **Ist das Ethernet-Kabel korrekt angeschlossen?**\
  → Das **Ethernet-Kabel mit Internetzugang** muss im Edge Device-Port mit der Aufschrift **„Internet“** eingesteckt sein.\
  ⚠️ Über alle anderen Ports am Edge Device kann **kein Internet-Uplink** hergestellt werden.
* [ ] **Ist das andere Ende des Ethernet-Kabels korrekt angeschlossen?**\
  → Prüfe, ob das Kabel mit einem **aktiven Netzwerkport mit Internetzugang** verbunden ist (z. B. Switch, Router oder Wanddose).

Wenn alle Punkte zutreffen, kannst du mit dem Diagnoseprozess starten.

## Diagnose

Unser Diagnoseprozess hilft dir dabei, die Ursache für den Verbindungsfehler Schritt-für-Schritt einzugrenzen und zu beheben.

#### ENLYZE EDGE aufrufen und Diagnose Prozess beginnen

Rufe ENLYZE EDGE auf dem jeweiligen Edge Device auf. Falls du Hilfestellung benötigst, findest du [hier](https://docs.enlyze.com/connect/edge-device/enlyze-edge/oberflache-aufrufen) den passenden Guide. Der Verbindungstest zur ENLYZE Manufacturing Data Platform wird automatisch gestartet, sobald du dich erfolgreich eingeloggt hast und stellt dar, in welchem Schritt die Verbindung fehlschlägt. Durch ein Klicken auf die Schaltfläche "Verbindung prüfen" kannst du jederzeit einen neuen Verbindungstest ausführen.

<figure><img src="https://3556205377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6Jn6Re8NNPSKD1jGZyL%2Fuploads%2Fxc0TSaQS8CyAFNGAopsv%2FSPARK%20Overview.png?alt=media&#x26;token=5e507ebd-cdf0-4d34-9969-928cf6e8a434" alt=""><figcaption></figcaption></figure>

Die Verbindungstests bauen aufeinander auf und laufen sequenziell ab, sodass du dir sicher sein kannst, dass du das Troubleshooting an der richtigen Stelle startest. Behebe den ersten Fehler, der die angezeigt wird und prüfe erneut die Verbindung, um zu sicherzustellen, dass das Edge Device wieder mit der ENLYZE Manufacturing Data Platform verbunden ist.

{% hint style="info" %}
Es kann sein, dass du die oben beschriebenen Schritte mehrmals durchlaufen musst, bis das Edge Device wieder online ist.
{% endhint %}

### Erweiterter Troubleshooting Prozess

Arbeite Schritt-für-Schritt durch den im folgenden dargestellten Prozess.

{% @mermaid/diagram content="%%{init: {'themeCSS': '.mermaid > svg { height: auto !important; margin-bottom: 0 !important; }'}}%%
flowchart TD
A(Start) --> B{Ist die Netzwerkkonfiguration korrekt?}
B -- Nein --> C\[Netzwerkkonfiguration korrekt einstellen]
C --> D\[Führe Verbindungstest durch]
B -- Ja --> D

```
D --> E{War der Verbindungstest erfolgreich?}
E -- Ja --> F[Gerät ist online ✅]
E -- Nein --> G{Ist Traffic in den Firewall-Logs für Edge Device sichtbar?}

G -- Ja --> H{Stimmt die MAC-Adresse mit eth0 überein?}
H -- Nein --> I[Passe MAC-Adresse in den Firewall-Regeln an]
I --> J[Führe Verbindungstest erneut durch]
H -- Ja --> J

G -- Nein --> K{Sind die Routen auf dem Edge Device korrekt eingerichtet?}
K -- Nein --> L[Korrigiere die Routing-Tabelle]
L --> J
K -- Ja --> M{Hat die Firewall eine UDP Flood Protection?}
M -- Ja --> N{Ist das Edge Device davon ausgenommen?}
N -- Nein --> O[Whiteliste das Edge Device im UDP Flood Modul]
N -- Ja --> P[Kontaktiere ENLYZE Support]
M -- Nein --> P

J --> Q{War der Verbindungstest erfolgreich?}
Q -- Ja --> F
Q -- Nein --> P
```

" %}

## **Übersicht Firewall Einstellungen**

Fehlerhafte Einstellungen in der Firewall sind der häufigste Grund, warum es zu einem Verbindungsproblem kommt. Stelle sicher, dass die folgenden Regeln eingestellt sind.

| Host                                             | Port                | Transport       | Zweck                                                                                |
| ------------------------------------------------ | ------------------- | --------------- | ------------------------------------------------------------------------------------ |
| 1.1.1.1                                          | 53 (DNS)            | TCP **und** UDP | Auflösung von Hostnamen zu IP-Adressen                                               |
| 8.8.4.4                                          | 53 (DNS)            | TCP **und** UDP | Auflösung von Hostnamen zu IP-Adressen                                               |
| 8.8.8.8                                          | 53 (DNS)            | TCP **und** UDP | Auflösung von Hostnamen zu IP-Adressen                                               |
| <p>iot-edge-1.enlyze.com<br>(159.69.177.150)</p> | 51821 (Wireguard)   | UDP             | Datentransfer in die ENLYZE-Cloud, Edge Device-Konfiguration, Einspielen von Updates |
| <p>ntp1.enlyze.com<br>(157.90.230.207)</p>       | <p>123<br>(NTP)</p> | UDP             | Synchronisierung Systemzeit                                                          |
| <p>ntp2.enlyze.com<br>(162.55.43.234)</p>        | 123 (NTP)           | UDP             | Synchronisierung Systemzeit                                                          |
|                                                  |                     |                 |                                                                                      |

**Edge Devices müssen in der UDP Flood Attack Protection ausgenommen werden**

Um eine reibungslose Kommunikation zu gewährleisten, ist es notwendig, die **Edge Devices im UDP Flood Protection-Modul zu whitelisten**. Mehr Information findest du [hier](https://github.com/enlyze/enlyze-docs/blob/main/de/connect/edge-device/spark-inbetriebnahme/vorbereitung.md#whitelisting-im-udp-flood-attack-modul-der-firewall).

{% hint style="info" %}
Falls das Verbindungsproblem nicht gelöst werden kann, du dir unsicher bist oder nicht weiterkommst, melde dich bei uns unter [**support@enlyze.com**](mailto:support@enlyze.com). Wir helfen dir schnell und unkompliziert weiter!
{% endhint %}
