Anwendungsverwaltung
Das Gateway kann neben der PLC-Datenerfassung auch mehrere Zusatztools (Dashboard, Datenfluss, Monitoring usw.) betreiben. Auf diesem Bildschirm sehen Sie den Status dieser Tools auf einen Blick und können sie starten/stoppen/neu starten oder neue Apps bereitstellen.
Dieser Bildschirm zeigt die Container des Host-Docker (Verwendung von /var/run/docker.sock-Mount).
plantpulse-edge Der eigene Container wird self-excluded – er erscheint nicht in der Liste, und alle Aktionen wie start/stop/delete/
inspect/logs/stats/deploy werden über IllegalStateException abgelehnt (um zu verhindern, dass der eigene Container gestoppt oder
gelöscht werden kann).
Ein Neustart von plantpulse-edge erfolgt über SSH mit systemctl restart plantpulse-edge.service
oder über die Schaltfläche „Neustart“ in der Statusleiste (über Signal-Datei).
1. Bildschirm öffnen
Klicken Sie auf die Karte [Anwendungen] im Hauptbildschirm oder geben Sie direkt /ui/apps in die Adressleiste ein.
┌────────────────────────────────────────────────────────────┐
│ ⊙ 애플리케이션 — 엣지에 배포된 컨테이너 · 시작/중지/재시작 │
│ [↻ 새로고침] [+ 새 앱 배포] │
├────────────────────────────────────────────────────────────┤
│ ℹ 이 화면에서는 엣지에 설치된 애플리케이션의 현재 상태를 │
│ 한눈에 확인하고, 필요할 때 시작·중지·재시작 할 수 있습니다.│
├────────────────────────────────────────────────────────────┤
│ [앱 카드] [앱 카드] [앱 카드] │
│ [앱 카드] [앱 카드] ... │
└────────────────────────────────────────────────────────────┘
Die Zurück-Schaltfläche (← Taste) früherer Versionen wurde entfernt – verwenden Sie das Symbol oder Logo in der oberen Leiste, um zu anderen Bildschirmen zu navigieren.
2. Aktionen oben
| Schaltfläche | Aktion |
|---|---|
↻ Aktualisieren (fa-sync) | apps.refresh() – sofortiges Neuzeichnen der Karten |
+ Neue App bereitstellen (fa-plus) | apps.openDeploy() – Modal zum Definieren + Registrieren neuer Container (benutzerdefiniertes Image / Port-Mapping / Umgebungsvariablen) |
Das kleine graue Label oben rechts (#apps_status_label) zeigt gelegentlich den letzten Aktualisierungszeitpunkt an, um zu signalisieren, dass die automatische Abfrage aktiv ist.
3. Kartenstruktur
Jede App wird als abgerundete Karte (20px Radius + grauer Rahmen) dargestellt und hebt sich beim Hover leicht an.
| Kartenelement | Bedeutung |
|---|---|
| Großes Symbol links (Quadrat, hellblauer Hintergrund) | App-Typ – basierend auf Container-Image |
| App-Name | Docker-Containername (z. B. pp-grafana, pp-node-red) |
| Status-Badge (abgerundete Kapsel) | running (grün) / exited dead restarting (rot) / paused (orange) / created (grau) |
| Image | Mono-Schrift + graue Box. Verwendetes Docker-Image (z. B. grafana/grafana:10.3) |
| Port | Klick → öffnet die App-Ansicht automatisch in neuem Fenster (z. B. 3000 → http://게이트웨이:3000/) |
| Erstellt | Zeitpunkt der Container-Erstellung |
| Ressourcen | CPU / Speicher (nur für laufende Apps, docker stats-Ergebnis) |
| Aktionsbereich (unten auf der Karte) | [Start] [Stopp] [Neustart] [Logs] -Schaltflächen – je nach Status aktiv/inaktiv |
Der Bildschirm wird alle 10 Sekunden automatisch aktualisiert – nach einem Aufruf des Backends /apps/list wird neu gezeichnet.
Häufig vorkommende Zusatz-Apps
| Tool | Rolle |
|---|---|
| Grafana | Zeitreihen-Diagramme / Betriebs-Dashboard |
| Node-RED | No-Code-Datenfluss / Automatisierung |
| HiveMQ (MQTT-Broker) | Nachrichtenvermittlung (Sparkplug B-Publisher) |
| Cassandra | Zeitreihen-Speicher |
| Portainer | Visuelle Docker-Containerverwaltung |
| Uptime Kuma | Einfache Verfügbarkeitsüberwachung (tot oder lebendig) |
| File Browser | Web-Dateimanager |
Installierte Apps variieren je nach Umgebung. Welche Apps sichtbar sind, ist das Ergebnis einer Remote-Bereitstellung durch den Systemadministrator über die IIoT-Plattform.
Häufige Aufgaben
App-Ansicht öffnen
Klicken Sie auf die Portnummer auf der Karte, um die Ansicht der jeweiligen App in einem neuen Fenster zu öffnen.
- In der Regel wird automatisch im Format
http://게이트웨이IP:포트/verbunden - Jede App kann eine eigene Anmeldung erfordern (z. B. Grafana, Portainer)
Zusatz-App starten / stoppen / neu starten
| Aktion | Vorgehen | Hinweis |
|---|---|---|
| Starten | [Start]-Schaltfläche auf der Karte | Nur aktiv, wenn gestoppt |
| Stoppen | [Stopp]-Schaltfläche auf der Karte | Nur aktiv, wenn läuft / pausiert |
| Neustart | [Neustart]-Schaltfläche | Immer verfügbar |
Ein Bestätigungsdialog erscheint, sodass Sie versehentliches Klicken mit [Abbrechen] rückgängig machen können.
App-Logs anzeigen
[Logs]-Schaltfläche auf der Karte → zeigt die letzten 200 Zeilen auf schwarzem Bildschirm. Verwenden Sie dies, um die Ursache zu analysieren, wenn die App nicht startet, oder um sie an den Systemadministrator weiterzuleiten.
Aktualisieren
Die [Aktualisieren]-Schaltfläche oben links aktualisiert sofort (unabhängig von der automatischen 10-Sekunden-Aktualisierung).
Gateway-Selbstverwaltung (Schnellaktionen in der Statusleiste)
Die Statusleiste unten links steuert über 7 Symbole das Gateway-Betriebssystem / die Anwendung selbst – auf allen Seiten verfügbar.
Detaillierte Abläufe / benötigte Zeit / Hinweise finden Sie im separaten Dokument Statusleisten-Schnellaktionen.
| Symbol | Aktion | Hinweis |
|---|---|---|
🎬 (fa-projector) System-Neustart | OS-Neustart | ca. 3–5 Minuten – unterbricht die gesamte PLC-Erfassung |
🔁 (fa-repeat-1-alt) Anwendungs-Neustart | Nur Tomcat / Gateway-SW neu starten | unter 1 Minute |
🗑 (fa-trash) Temporäre Dateien bereinigen | Temp-/Cache-Bereinigung | bei Speicherplatzmangel |
⏱ (fa-stopwatch) Backup | Konfiguration + DB sichern | Backup / Wiederherstellung |
📄 (fa-file-alt) Logs herunterladen | Diagnose-Logs als Zip | bei Problemberichten anhängen |
🔌 (fa-microchip) O/S- und Firmware-Upgrade | Firmware-Update | vorsichtig durchführen |
☁ (fa-cloud-download) S/W-Upgrade | Gateway-SW-Update (product.kopens.io) | nur aktiv, wenn das Badge Upgrade verfügbar! oben rechts angezeigt wird |
Während eines Neustarts / Upgrades ist die PLC-Werterfassung vorübergehend unterbrochen. Führen Sie diese Vorgänge außerhalb der Betriebszeiten durch.
Gateway-Installation
Für Systemadministratoren – bei der Erstinstallation in einer neuen Umgebung.
Die Standardinstallation wird normalerweise im Voraus vom Systemadministrator durchgeführt. Falls Sie jedoch in einer neuen Umgebung erstmalig installieren, können Sie dies mit dem folgenden Einzeiler-Befehl erledigen.
bash < <(curl -s http://product.kopens.io/plantpulse-edge/install.sh)
Intern werden JDK / Tomcat / Cassandra / Gateway vollständig installiert.
Für detaillierte Build-/Bereitstellungs-/Konfigurationsschritte siehe app.properties-Referenz und die erweiterten – Entwicklerhinweise.
Häufig gestellte Fragen
F: Die Anwendung ist „gestoppt“ und startet nicht
Mögliche Ursachen sind unzureichende PC-Ressourcen (z. B. Speichermangel) oder ein Portkonflikt.
- Prüfen Sie die Speicher-/Festplattenanzeige im Hauptbildschirm
- Versuchen Sie [Einstellungen] → [Temporäre Dateien bereinigen]
- Wenn weiterhin erfolglos, prüfen Sie die Fehlermeldung über die [Logs]-Schaltfläche und leiten Sie sie an den Systemadministrator weiter
F: Gehen PLC-Verbindungen / Tags nach einem Gateway-Neustart verloren?
Nein. Die Konfiguration wird sicher gespeichert und nach dem Neustart automatisch wiederhergestellt. PLCs, die auf „Auto-Start“ gesetzt sind, setzen die Erfassung automatisch fort.
F: Können Zusatz-Apps auf einem separaten PC installiert werden, getrennt vom Gateway?
Ja, aber die empfohlene Konfiguration ist derselbe PC. Besprechen Sie dies mit Ihrem Systemadministrator.