Anwendungsverwaltung (/ui/apps)
Das Gateway kann neben der PLC-Datenerfassung auch mehrere Zusatzwerkzeuge (Dashboards, Datenflüsse, Monitoring usw.) betreiben. Auf diesem Bildschirm sehen Sie den Status dieser Werkzeuge auf einen Blick und erledigen Start/Stopp/Neustart bis hin zum Deployment neuer Apps.
Dieser Bildschirm zeigt die Container des Host-Docker an (Verwendung des /var/run/docker.sock-Mounts).
plantpulse-edge selbst ist self-exclude — es erscheint nicht in der Liste, und alle Aktionen start/stop/delete/
inspect/logs/stats/deploy werden mit IllegalStateException abgewiesen (damit man sich nicht selbst abschalten oder
löschen kann).
Der Neustart von plantpulse-edge erfolgt per SSH mit systemctl restart plantpulse-edge.service
oder über die Schaltfläche „Neustart" in der Statusleiste (via Signal File).
1. Bildschirm öffnen
Klicken Sie auf dem Hauptbildschirm die Karte [Anwendungen] an oder geben Sie /ui/apps direkt in die Adresszeile ein.
┌────────────────────────────────────────────────────────────┐
│ ⊙ 애플리케이션 — 엣지에 배포된 컨테이너 · 시작/중지/재시작 │
│ [↻ 새로고침] [+ 새 앱 배포] │
├────────────────────────────────────────────────────────────┤
│ ℹ 이 화면에서는 엣지에 설치된 애플리케이션의 현재 상태를 │
│ 한눈에 확인하고, 필요할 때 시작·중지·재시작 할 수 있습니다.│
├────────────────────────────────────────────────────────────┤
│ [앱 카드] [앱 카드] [앱 카드] │
│ [앱 카드] [앱 카드] ... │
└────────────────────────────────────────────────────────────┘
Die Schaltfläche ← Zurück früherer Versionen wurde entfernt — Navigation zu anderen Bildschirmen über die linke Sidebar bzw. einen Klick auf das Logo.
2. Aktionen in der Kopfzeile
| Schaltfläche | Aktion |
|---|---|
↻ Aktualisieren (fa-sync) | apps.refresh() — Karten sofort neu zeichnen |
+ Neue App deployen (fa-plus) | apps.openDeploy() — Modal zur Definition und Registrierung eines neuen Containers (benutzerdefiniertes Image / Port-Mapping / Umgebungsvariablen) |
Im kleinen grauen Label oben rechts (#apps_status_label) wird gelegentlich der Zeitpunkt der letzten Aktualisierung angezeigt und signalisiert damit, dass das automatische Polling aktiv ist.
3. Kartenaufbau
Jede App wird als Karte mit abgerundeten Ecken (20 px Radius + grauer Rahmen) dargestellt und hebt sich beim Überfahren leicht an.
| Kartenelement | Bedeutung |
|---|---|
| Großes Symbol links (Quadrat, hellblauer Hintergrund) | App-Typ — basierend auf dem Container-Image |
| App-Name | Name des Docker-Containers (z. B. pp-grafana, pp-node-red) |
| Status-Badge (abgerundete Kapsel) | running (grün) / exited dead restarting (rot) / paused (orange) / created (grau) |
| Image | Mono-Font + graues Feld. Verwendetes Docker-Image (z. B. grafana/grafana:10.3) |
| Port | Klick → App-Oberfläche öffnet automatisch in neuem Fenster (z. B. 3000 → http://게이트웨이:3000/) |
| Erstellt | Zeitpunkt der Container-Erstellung |
| Ressourcen | CPU / Speicher (nur bei laufenden Apps, Ergebnis von docker stats) |
| Aktionsbereich (unten auf der Karte) | Schaltflächen [Start] [Stopp] [Neustart] [Logs] — je nach Status aktiv/inaktiv |
Der Bildschirm wird alle 10 Sekunden automatisch aktualisiert — nach dem Backend-Aufruf /apps/list erfolgt ein Neuzeichnen.
Häufig vorhandene Zusatz-Apps
| Werkzeug | Funktion |
|---|---|
| Grafana | Zeitreihen-Diagramme / Betriebs-Dashboards |
| Node-RED | No-Code-Datenflüsse / Automatisierung |
| HiveMQ (MQTT-Broker) | Nachrichtenvermittlung (Publisher für Sparkplug B) |
| Cassandra | Zeitreihen-Speicher |
| Portainer | Visuelle Verwaltung von Docker-Containern |
| Uptime Kuma | Einfaches Verfügbarkeits-Monitoring (erreichbar oder nicht) |
| File Browser | Web-Dateimanager |
Welche Apps installiert sind, unterscheidet sich je nach Umgebung. Was Sie sehen, ist das Ergebnis des Remote-Deployments durch den Systemadministrator über die IIoT-Plattform.
Häufige Aufgaben
Oberfläche einer Zusatz-App öffnen
Ein Klick auf die Portnummer der Karte öffnet die Oberfläche der jeweiligen App in einem neuen Fenster.
- In der Regel automatische Verbindung im Format
http://게이트웨이IP:포트/ - Manche Apps erfordern eine eigene Anmeldung (z. B. Grafana, Portainer)
Zusatz-App starten / stoppen / neu starten
| Aktion | Vorgehen | Hinweis |
|---|---|---|
| Start | Schaltfläche [Start] auf der Karte | Nur im gestoppten Zustand aktiv |
| Stopp | Schaltfläche [Stopp] auf der Karte | Nur bei laufendem / pausiertem Zustand aktiv |
| Neustart | Schaltfläche [Neustart] | Immer verfügbar |
Es erscheint jeweils eine Bestätigungsabfrage, sodass ein versehentlicher Klick mit [Abbrechen] rückgängig gemacht werden kann.
Logs einer Zusatz-App ansehen
Schaltfläche [Logs] auf der Karte → zeigt die letzten 200 Zeilen auf schwarzem Hintergrund. Nutzen Sie dies zur Ursachenanalyse, wenn eine App nicht startet, oder zur Weitergabe an den Systemadministrator.
Aktualisieren
Mit der Schaltfläche [Aktualisieren] oben links lässt sich die Ansicht sofort aktualisieren (unabhängig von der automatischen Aktualisierung alle 10 Sekunden).
Verwaltung des Gateways selbst (Schnellaktionen der Statusleiste)
Über die 7 Symbole der Statusleiste unten links steuern Sie das Gateway-Betriebssystem bzw. die Anwendung selbst — auf allen Seiten verfügbar.
Details zu Ablauf, Dauer und Vorsichtsmaßnahmen sind im separaten Dokument Schnellaktionen der Statusleiste zusammengefasst.
| Symbol | Aktion | Hinweis |
|---|---|---|
🎬 (fa-projector) System-Reboot | Betriebssystem neu starten | ca. 3–5 Minuten — gesamte PLC-Erfassung unterbrochen |
🔁 (fa-repeat-1-alt) Anwendung neu starten | Nur Tomcat / Gateway-Software neu starten | Unter 1 Minute |
🗑 (fa-trash) Temporäre Dateien bereinigen | Temp- / Cache-Bereinigung | Bei zu wenig Speicherplatz |
⏱ (fa-stopwatch) Backup | Backup von Konfiguration + DB | Backup / Wiederherstellung |
📄 (fa-file-alt) Logs herunterladen | Diagnose-Logs als ZIP | Bei Problemmeldungen anhängen |
🔌 (fa-microchip) O/S- und Firmware-Upgrade | Firmware-Update | Mit Bedacht ausführen |
☁ (fa-cloud-download) S/W-Upgrade | Update der Gateway-Software (product.kopens.io) | Nur aktiv, wenn oben rechts das Badge Upgrade verfügbar! erscheint |
Während Neustart bzw. Upgrade wird die Erfassung der PLC-Werte vorübergehend unterbrochen. Wir empfehlen, dies außerhalb der Betriebszeiten durchzuführen.
Installation des Gateways selbst
Für Systemadministratoren — bei der Erstinstallation in einer neuen Umgebung.
Die Basisinstallation nimmt normalerweise der Systemadministrator vorab vor. Bei einer Erstinstallation in einer neuen Umgebung lässt sich mit folgendem Einzeiler alles auf einmal installieren.
bash < <(curl -s http://product.kopens.io/plantpulse-edge/install.sh)
Intern werden JDK / Tomcat / Cassandra / Gateway vollständig installiert.
Wenn Sie detaillierte Abläufe zu Build / Deployment / Konfiguration benötigen, lesen Sie Erweitert — Leitfaden zu Konfigurationsdateien sowie Erweitert — Entwicklerhinweise.
Häufig gestellte Fragen
F. Die Anwendung ist im Status „Gestoppt", lässt sich aber nicht starten
Möglicherweise fehlen PC-Ressourcen (z. B. zu wenig Arbeitsspeicher) oder es liegt ein Portkonflikt vor.
- Auf dem Hauptbildschirm die Anzeigen für Speicher / Festplatte prüfen
- [Einstellungen] → [Temporäre Dateien bereinigen] versuchen
- Falls es weiterhin nicht funktioniert, über die Schaltfläche [Logs] die Fehlermeldung prüfen und an den Systemadministrator weitergeben
F. Gehen beim Neustart des Gateways die PLC-Verbindungen / Tags verloren?
Nein. Die Konfiguration wird sicher gespeichert und nach dem Neustart automatisch wiederhergestellt; PLCs mit der Einstellung „Automatischer Start" nehmen die Erfassung selbsttätig wieder auf.
F. Können Zusatz-Apps getrennt vom Gateway auf einem anderen PC laufen?
Das ist möglich, empfohlen wird jedoch derselbe PC. Sprechen Sie sich mit Ihrem Systemadministrator ab.