Zum Hauptinhalt springen

Fehlerbehebung

Nach Symptomen geordnet, damit Sie schnell zur Lösung finden.

Container-Modus-Box

Wenn systemctl is-active plantpulse-edge.service auf active steht, läuft der Container-Modus — für einige Symptome liefert der Abschnitt „Störungsbehandlung" im Betriebshandbuch Container-Modus oder die Szenario-Matrix (A~E) in der Box unter /opt/kopens/install/RUNBOOK.md eine schnellere Diagnose. Diagnoseinformationen gesammelt erfassen:

sudo bash /opt/kopens/install/bin/doctor.sh
# → /tmp/pe-doctor-`<host>`-`<ts>`.tar.zst (support 전달)

Schnellindex​

SymptomWeiter zu
Die Gateway-Oberfläche öffnet sich nichtDie Oberfläche öffnet sich nicht
Anmeldung nicht möglichAnmeldung nicht möglich
Keine Verbindung (PLC)Keine Verbindung
Verbindung steht, aber es kommen keine Werte anEs kommen keine Werte an
Werte kommen an, sind aber unplausibelDie Werte sind unplausibel
Werte kommen plötzlich nicht mehr anDie Werte sind plötzlich abgerissen
Die Oberfläche ist langsamDie Oberfläche ist langsam
Speicher/Festplatte sind rotDie Ressourcen reichen nicht
Datenübertragung an Cloud / SCADA schlägt fehlDie Übertragung funktioniert nicht
Tag [Schreiben] funktioniert nichtWerte lassen sich nicht schreiben

Die Oberfläche öffnet sich nicht​

Sie haben die Gateway-IP im Browser eingegeben, aber die Seite wird nicht angezeigt.

Schritt 1 — Prüfen, ob das Gateway vom PC aus erreichbar ist​

In der Eingabeaufforderung:

ping <gateway-ip>

Bleibt eine Antwort aus, liegt ein Netzwerk-, Kabel- oder VPN-Problem vor. Melden Sie dem Systemadministrator: „Das Gateway ist nicht erreichbar."

Schritt 2 — Anderen Browser / anderen Benutzer versuchen​

Tritt das Symptom auch an einem anderen PC auf, ist das Gateway selbst wahrscheinlich ausgeschaltet oder hängt. Der Systemadministrator muss den Gateway-PC neu starten.

Schritt 3 — URL prüfen​

  • http://게이트웨이IP/ ist das übliche Format.
  • Manchmal ist zusätzlich eine Portnummer angehängt (z. B. http://게이트웨이IP:8080/).
  • Wenn Sie die firmeninterne Standard-URL nicht kennen, fragen Sie einen Kollegen.

Anmeldung nicht möglich​

Passwort vergessen​

Versuchen Sie es mit dem Standardpasswort.

  • ID: admin
  • Passwort: admin123!

Wurde es in Ihrer Umgebung bereits geändert, fordern Sie beim Systemadministrator ein Zurücksetzen des Passworts an.

Sofortiger Rauswurf nach der Anmeldung​

Möglicherweise ein Session- oder Cookie-Problem. Löschen Sie die Cookies im Browser und versuchen Sie es erneut.

Keine Verbindung​

Im Bildschirm [Verbindung] wird rot „Verbindung fehlgeschlagen" angezeigt.

Schritt 1 — Ist die PLC vom selben PC aus erreichbar?​

Lassen Sie vom Systemadministrator prüfen, ob vom Gateway-PC aus ein ping an die PLC-IP durchgeht.

Schritt 2 — Stimmt der Port?​

Standardports nach PLC-Typ:

PLCPort
OPC-UA (Kepware)49320
Modbus TCP502
Mitsubishi (Q/L)5000 oder 1029 (PLC-Einstellwert)
Mitsubishi (iQ-R)1500
Siemens S7102
LS2004
AB EtherNet/IP44818

Das Kommunikationsmodul auf PLC-Seite muss aktiviert sein.

Schritt 3 — Sicherheitseinstellungen auf PLC-Seite​

PLCZusätzlich erforderliche Einstellung
Siemens S7Im TIA Portal „PUT/GET-Kommunikation zulassen" aktivieren + Optimized-Modus des DB auf OFF
MitsubishiIn GX Works „MC-Protokoll / TCP / Port" aktivieren
OPC-UABenutzer / Passwort oder anonymen Zugriff zulassen
LSICMP (ping) darf nicht blockiert sein

Schritt 4 — Benutzer / Passwort​

Bei PLCs mit Authentifizierung wie OPC-UA müssen ID und Passwort exakt stimmen. Geben Sie sie im Formular [Bearbeiten] der PLC erneut ein und versuchen Sie es nochmals.

Es kommen keine Werte an​

Die Verbindung ist „normal verbunden", aber das Feld [Aktueller Wert] des Tags bleibt leer.

Schritt 1 — PLC-Adressnotation prüfen​

Die häufigste Ursache. Die Notation unterscheidet sich je nach PLC-Typ.

  • Mitsubishi: D100, M50 (ohne vorangestelltes %)
  • Siemens: %DB1.DBW0 (vorangestelltes %, DB-Nummer + DBW/DBD)
  • LS: D00309 (5-stellige Zahl)
  • OPC-UA: Format ns=2;s=경로

Prüfen Sie den Abschnitt [PLC-Adressnotation] auf der Seite Ihrer PLC noch einmal.

Schritt 2 — Datentyp / Formatzusatz prüfen​

Handelt es sich um einen Wert mit 32 Bit oder mehr und [Formatzusatz] ist leer, wird er fälschlich als 16 Bit gelesen und der Wert erscheint möglicherweise nicht.

  • 32-Bit-Ganzzahl: Formatzusatz = DW
  • 32-Bit-Gleitkommazahl: Formatzusatz = REAL
  • 64-Bit-Gleitkommazahl: Formatzusatz = LREAL

Schritt 3 — Dieselbe Adresse mit einem anderen Werkzeug verifizieren​

Prüfen Sie im Monitor-/Watch-Fenster des PLC-Engineering-Tools (GX Works / TIA Portal / XG5000 / UA Expert), ob dieselbe Adresse tatsächlich funktioniert.

Die Werte sind unplausibel​

Werte kommen an, sind aber zu groß, zu klein oder haben das falsche Vorzeichen.

32-Bit-Wert wird als 16 Bit gelesen​

Typisches Muster: Werte wirken zufällig oder eine Hälfte erscheint abgeschnitten. Geben Sie unter [Formatzusatz] DW (Ganzzahl) oder REAL (Gleitkommazahl) an.

Vorzeichenloser Wert wird als vorzeichenbehaftet gelesen​

Beispiel: 65535 erscheint als -1. Unter [Formatzusatz] UI (16 Bit vorzeichenlos) oder UDW (32 Bit vorzeichenlos) angeben.

Byte-/Word-Reihenfolge (Endianness) vertauscht​

Sendet ein bestimmter Slave (häufig bei Modbus-Slaves) die Werte little-endian, erscheinen 32-Bit-Gleitkommazahlen verfälscht.

  • Bei Modbus: Varianten der Datentypnotation wie :UDINT_LSWORD_FIRST ausprobieren
  • Bei anderen PLCs lässt sich das teilweise nicht per Formel anwenden nachbearbeiten — wenden Sie sich an den Systemadministrator

Abweichende Einheit​

Die PLC sendet einen ganzzahligen Rohwert (z. B. 1638), gemeint ist aber tatsächlich 163.8. Über Formel anwenden ${VALUE}*0.1 eingeben und so die Einheit umrechnen.

Die Werte sind plötzlich abgerissen​

Werte kamen zuverlässig an und bleiben ab einem bestimmten Zeitpunkt aus.

Schritt 1 — Verbindungsstatus prüfen​

Welchen Verbindungsstatus hat diese PLC im Menü [Verbindung]?

StatusBedeutung / nächster Schritt
Rot „Verbindung fehlgeschlagen"Problem auf PLC-Seite. PLC neu starten oder Kabel / Netzwerk prüfen
Grau „Gestoppt"Jemand hat [Stopp] gedrückt oder es erfolgte ein automatischer Stopp. Mit [Start] fortsetzen
Grün „Normal verbunden" + nur keine WerteMöglicherweise wurde diese Adresse in der PLC deaktiviert

Schritt 2 — PLC selbst prüfen​

  • Befindet sich die PLC im RUN-Modus? (Bei STOP bleiben die Werte stehen)
  • Wurde der Speicherschutz für diesen Adressbereich geändert?
  • Direkt nach einem Firmware-Update oder Neustart der PLC: kurz abwarten, die Verbindung wird automatisch wiederhergestellt

Schritt 3 — Gateway neu starten​

Über [Einstellungen] → [Anwendung neu starten] das Gateway selbst neu hochfahren. Die Wiederherstellung erfolgt innerhalb einer Minute.

Die Oberfläche ist langsam​

Bei sehr vielen PLCs oder Tags kann das erste Laden 1–2 Sekunden dauern.

  • In der Regel unproblematisch.
  • Ist die CPU-Anzeige auf dem Hauptbildschirm rot, reichen die Ressourcen des Gateway-PCs möglicherweise nicht aus. Wenden Sie sich an den Systemadministrator.

Die Ressourcen reichen nicht​

Die Anzeigen für CPU / Speicher / Festplatte auf dem Hauptbildschirm werden rot dargestellt.

AnzeigeMaßnahme
CPUPrüfen, ob eine PLC mit zu kurzem Erfassungsintervall betrieben wird. Auf 1 Sekunde oder mehr erhöhen
SpeicherÜber [Einstellungen] → [Anwendung neu starten] vorübergehend zu beheben. Bei Wiederholung Speichererweiterung beim Systemadministrator anfordern
Festplatte[Einstellungen] → [Temporäre Dateien bereinigen]. Möglicherweise ist auch die Aufbewahrungsdauer der Zeitreihe zu lang

Die Übertragung funktioniert nicht​

Werte werden korrekt erfasst, gelangen aber nicht an Cloud / SCADA / MQTT.

MQTT / Sparkplug veröffentlicht nicht​

  • Beim Systemadministrator den „MQTT-Aktivierungsstatus" prüfen lassen
  • Prüfen, ob auf demselben Gateway-PC ein MQTT-Broker (z. B. HiveMQ) läuft

Keine Antwort der Platform-API​

  • Die PlantPulse Platform selbst ist nicht erreichbar → an Zentrale / Betriebsteam wenden
  • Das Gateway puffert die Daten in einer Queue, kurzzeitige Unterbrechungen werden automatisch aufgeholt.

Ausführliche Log-Schlüsselwörter und Log-Speicherorte für Systemadministratoren finden Sie unter Erweitert — Entwicklernotizen.

Letzte Möglichkeit​

  • [Einstellungen] → [Logs herunterladen] für den gesammelten Download der Diagnoselogs
  • [Einstellungen] → [Anwendung neu starten] startet nur das Gateway neu (1 Minute)
  • [Einstellungen] → [System-Reboot] startet den PC selbst neu (3–5 Minuten)

Lässt sich das Problem weiterhin nicht beheben, wenden Sie sich mit den heruntergeladenen Logs im Anhang an KOPENS oder das PlantPulse-Betriebsteam.

Werte lassen sich nicht schreiben​

Sie haben am Ende der Tag-Zeile auf das Symbol [Schreiben] geklickt und erhalten Meldungen wie „Schreiben fehlgeschlagen" / „driver returned false".

Schreibunterstützung nach Protokoll​

Ob Schreiben unterstützt wird, hängt vom PLC-Typ ab.

Ihre PLCSchreiben unterstütztHinweis
Mitsubishi (MELSEC)✅ möglichQ/L/iQ-R werden alle unterstützt
Siemens (S7)✅ möglichBereiche DB/M/I/Q
OPC-UA (z. B. Kepware)✅ möglichWrite-Berechtigung für den Zielknoten erforderlich
Modbus TCP✅ möglichHolding Register / Coil
HTTP-Push✅ möglich (Cache)—
LS ELECTRIC (XGI/XBC/XBM)✅ möglichBit/Byte/Word/DWord/Float/Double
AB EtherNet/IP✅ möglichJe nach PLC-Firmware/Patch können einzelne Typen abgelehnt werden

Häufige Meldungen​

MeldungBedeutung / Maßnahme
쓰기 실패 (opc_type=...)Der Treiber hat false zurückgegeben. Adressformat, Datentyp (format) und Write-Berechtigung der PLC prüfen
tag not found: ...Ungültige Tag-ID. Seite aktualisieren und erneut versuchen
scheduler not running for opc_id=...Die betreffende PLC ist im Zustand [Gestoppt]. [Start] drücken und erneut versuchen
OPC ... 가 PLC 와 연결되어 있지 않습니다Schreibversuch im Zustand DISCONNECTED — IP/Port/Firewall prüfen und neu starten

Wenn es dann immer noch nicht klappt​

  • Teilen Sie dem Systemadministrator [PLC-Typ + Tag-ID + vollständige Meldung] mit.
  • Im Gateway-Log finden Sie genauere Hinweise auf die Ursache.