Störungen an Verbindungen finden

Fangen Sie immer bei Einstellungen → Verbindungen an. Dort steht der Zustand jeder Verbindung samt Zeitpunkt und der Zahl der Tags, die daran hängen.

Der Zustand in der Liste

Zustand	Wahrscheinlichste Ursache	Nächster Schritt
verbindet … dauerhaft	Netzadresse oder Port falsch, Weg blockiert	Erreichbarkeit vom Server aus prüfen
offline	die Gegenstelle antwortet nicht mehr	Maschine, Broker, Netz prüfen; TrakState versucht es selbst weiter
Fehler	die Meldung steht daneben, Zugangsdaten sind entfernt	Meldung lesen; oft Anmeldung oder Zertifikat
nicht in Betrieb	für dieses Protokoll läuft keine Laufzeit	ist das Plugin eingeschaltet, läuft sein Backend?
ausgeschaltet	jemand hat die Verbindung deaktiviert	wieder einschalten

Was am Tag zu sehen ist

• schlecht — die Verbindung ist weg, oder eine Nachricht kam an, aus der sich kein Wert lesen ließ (zum Beispiel ein fehlender JSON-Pfad). Der letzte Wert wird bewusst nicht weitergezeigt.
• unsicher — das Tag ist angelegt, aber noch keinem Konnektor oder keiner Verbindung zugeordnet.
• verweigert — der Zugriff wurde abgelehnt, nicht die Verbindung.

Es sind immer nur die Tags dieser einen Verbindung betroffen.

Schreiben schlägt fehl

Meldung sinngemäß	Ursache
„die Verbindung ist offline, der Wert wurde NICHT gesendet”	kein aufgebauter Draht — es wird nichts in eine Warteschlange gelegt
keine Bestätigung in fünf Sekunden	die Gegenstelle hat nicht quittiert
Schreiben auf ein eingehendes Tag	Richtung des Tags auf Schreibt zur Maschine oder Beides stellen
Topic mit Platzhalter	zum Schreiben muss das Topic eindeutig sein
kein Konnektor dieses Typs in Betrieb	das Protokoll hat auf dieser Anlage keine Laufzeit

Zugangsdaten und Schlüssel

Passwörter liegen verschlüsselt in der Datenbank; der Schlüssel liegt in einer Datei daneben. Daraus folgen zwei Fälle, die im Betrieb wirklich vorkommen:

• Kein Schlüssel vorhanden. Das Formular sagt es und speichert kein Passwort. Verbindungen ohne Passwort funktionieren weiter.
• Datenbank zurückgespielt, Schlüsseldatei nicht. Beim Start wird eine neue Schlüsseldatei angelegt, und die alten Zugangsdaten lassen sich nicht mehr öffnen. Die betroffenen Verbindungen werden namentlich protokolliert und bleiben unten. Der Ausweg ist die alte Schlüsseldatei aus der Sicherung — oder die Passwörter neu eintragen.

Merksatz: eine Sicherung besteht aus Datenbank und Schlüsseldatei.

Zwei Fallen, die wie Netzprobleme aussehen

• Gleiche Client-Kennung bei MQTT. Zwei Verbindungen mit derselben Kennung werfen sich gegenseitig vom Broker. Das sieht aus wie eine wackelige Leitung. Lassen Sie das Feld leer oder vergeben Sie unterschiedliche Kennungen.
• TCP ohne Trennzeichen. Ein zu kurzer Stille-Rückfall zerschneidet Telegramme, in denen der Sender kurz zögert; überschreitet ein Telegramm ohne Trennzeichen die Nachrichtengrenze, wird der Puffer verworfen. Beides erscheint als lückenhafte Daten, nicht als Fehler.

Wenn ein Plugin-Konnektor gar nichts tut

Prüfen Sie in dieser Reihenfolge:

1. Ist das Plugin unter Einstellungen → Plugins installiert und eingeschaltet?
2. Läuft sein Backend? Ein Plugin-Backend startet nicht, wenn seine Signatur nicht mehr gegen den Vertrauensanker der Anlage prüfbar ist — dann hilft nur eine neu signierte Fassung. Die Plugin-Seite zeigt den Vertrauenszustand.
3. Führt das Manifest net:socket? Ohne diese Berechtigung bekommt der Konnektor keine Laufzeit.
4. Steht das Protokoll überhaupt im Formular? Wenn nicht, wurde der Typ abgelehnt; der Grund steht im Protokoll der Anlage.