Schnellaktionen in der Statusleiste (auf allen Seiten)
In der Statusleiste unten links auf allen Seiten der Gateway-Web-UI befinden sich 7 Symbole für Schnellaktionen. Damit lassen sich OS/Anwendung neu starten sowie häufig benötigte Betriebsaktionen wie Datenträgerbereinigung, Backup oder Upgrade mit einem Klick ausführen.
Die Schaltflächen Neustart / Reboot / Temporärdateien bereinigen / Upgrade / firmware arbeiten im Container-Modus über Signaldateien.
Die UI ruft kein bash-Skript direkt auf; sie schreibt /etc/kopens/upgrade.request bzw.
/etc/kopens/host-action.request, und kopens-upgrade.path /
kopens-host-action.path (inotify) auf dem Host erkennt dies und führt die entsprechende Aktion aus (Pattern-B-Sicherheit — damit der Container nicht host-root-äquivalent wird). Das Ergebnis wird in /etc/kopens/upgrade.status / host-action.status
als JSON abgelegt und von der UI per Polling angezeigt.
┌──────────────────────────────────────────────────────────────┐
│ … 페이지 컨텐츠 … │
├──────────────────────────────────────────────────────────────┤
│ KOPENS Edge | 🎬 🔁 🗑 ⏱ 📄 🔌 ☁ | 버전 V2026.05.10 │
└──────────────────────────────────────────────────────────────┘
Bei jedem Symbol erscheint nach dem Klick ein Bestätigungsdialog; die Ausführung startet erst nach erneutem Klick auf [Bestätigen] (Schutz vor Fehlbedienung). Einige Aktionen zeigen zusätzlich ein rotes 〈Achtung〉-Badge zur Kennzeichnung des Risikos.
1. 🎬 System-Reboot (fa-projector)
Startet das Betriebssystem selbst neu. Die stärkste Aktion — im Normalbetrieb nicht verwenden.
| Punkt | Wert |
|---|---|
| Aufruf | bootbox.confirm → Backend-Reboot-Endpunkt |
| Tatsächliche Aktion | Betriebssystem reboot |
| Dauer | 3 – 5 Minuten (BIOS-POST + OS-Boot + Tomcat-Start + Cassandra) |
| PLC-Erfassung | währenddessen vollständig unterbrochen |
| Externer Zugriff | getrennt, bis der Ping auf die Gateway-IP ausfällt; nach dem Boot wieder verfügbar |
| Einsatzzeitpunkt | nach OS-Patches / Laden von Kernelmodulen / nach Hardware-Inspektion |
| Warnhinweis | 🔴 Achtung (rotes Badge) |
2. 🔁 Anwendung neu starten (fa-repeat-1-alt)
Startet nur Tomcat (Gateway-SW) neu. Das OS bleibt unberührt.
| Punkt | Wert |
|---|---|
| Tatsächliche Aktion | restart.sh (/opt/kopens/plantpulse-edge/bin/restart.sh) |
| Dauer | ca. 30 – 60 Sekunden |
| PLC-Erfassung | währenddessen kurz unterbrochen — nach dem Start automatische Wiederaufnahme |
| Einsatzzeitpunkt | Übernahme von app.properties-Änderungen / erneutes Binden des OPC-UA-Servers / Bereinigung von Speicheranhäufungen |
Neustart-Race: In manchen Umgebungen schlägt der ServerStartListener stillschweigend fehl, sodass der Monitor = null bleibt — dann genügt ein erneuter Aufruf von ./restart.sh (oder ein weiterer Klick auf diese Schaltfläche) für einen sauberen Start.
3. 🗑 Temporärdateien bereinigen (fa-trash)
Löscht Log-, Cache- und Upload-Reste und schafft so freien Speicherplatz.
| Punkt | Wert |
|---|---|
| Tatsächliche Aktion | clean.sh (Bereinigung beschränkt auf Präfixe der Gateway-Arbeitsverzeichnisse mit hoher Datenträgerbelegung) |
| Dauer | wenige bis einige zehn Sekunden |
| PLC-Erfassung | keine Auswirkung (nur Dateibereinigung) |
| Einsatzzeitpunkt | wenn die Karte Datenträger auf dem Hauptbildschirm über 90 % anzeigt / unmittelbar vor einem Upgrade / nach langem Dauerbetrieb |
Wenn die Karte Datenträger auf dem Startbildschirm rot ist, ist diese Schaltfläche die erste Maßnahme.
4. ⏱ Backup (fa-stopwatch)
Sichert Konfiguration + Betriebsdaten des Gateways in einer Backup-Datei.
| Punkt | Wert |
|---|---|
| Tatsächliche Aktion | backup.sh |
| Ergebnis | /opt/kopens/.../backup/<timestamp>.tar.gz |
| Umfang | app.properties, Teile der Cassandra-Keyspaces, Node-RED userDir, OPC-/Tag-Definitionen |
| Wiederherstellung | Backup / Wiederherstellung — separates Verfahren |
| Einsatzzeitpunkt | unmittelbar vor einem Upgrade / Umzug der Umgebung / regelmäßige Sicherung |
5. 📄 Logs herunterladen (fa-file-alt)
Lädt ein Diagnose-Logpaket sofort herunter.
| Punkt | Wert |
|---|---|
| Aufruf | location.href = "/log-download" (GET-Request, ZIP-Streaming vom Server) |
| Ergebnis | ZIP mit aktuellen Gateway-Logs + Diagnoseinformationen |
| Einsatzzeitpunkt | als Anhang bei Problemmeldungen an den Systemadministrator / Anforderung einer Ursachenanalyse |
Für die Suche im Loginhalt ist Systemlog anzeigen (
/system/log/list) komfortabler — mit Filtern für Zeitraum, Level und Suchbegriff.
6. 🔌 O/S- und Firmware-Upgrade (fa-microchip)
Aktualisiert Betriebssystem / BIOS / Geräte-Firmware. Die risikoreichste Aktion.
| Punkt | Wert |
|---|---|
| Tatsächliche Aktion | OS-Paketmanager + Firmware-Update-Skript des Herstellers |
| Dauer | einige Minuten bis einige zehn Minuten |
| PLC-Erfassung | währenddessen vollständig unterbrochen |
| Externer Zugriff | in einzelnen Phasen unterbrochen |
| Warnhinweis | 🔴 Achtung (rotes Badge) |
| Einsatzzeitpunkt | Sicherheitspatches / Herstellerempfehlung / Hinweis von KOPENS |
Ein Firmware-Upgrade kann Schritte ohne Rollback-Möglichkeit enthalten. Führen Sie es ausschließlich außerhalb der Betriebszeiten durch und erstellen Sie zuvor ein Backup (Nr. 4).
7. ☁ S/W-Upgrade (fa-cloud-download)
Lädt die Gateway-SW (diese Web-UI) vom Downloadserver und führt das Upgrade durch.
| Punkt | Wert |
|---|---|
| Downloadserver | product.kopens.io (oder interner Mirror) |
| Tatsächliche Aktion | upgrade.sh — neuen Build herunterladen → SHA256-Prüfung → Swap → Neustart |
| Dauer | 1 – 3 Minuten (Downloadgeschwindigkeit + Neustart) |
| PLC-Erfassung | Unterbrechung von unter 1 Minute |
| Badge oben rechts | rot Upgrade verfügbar! = neue Version auf dem Downloadserver / grau Nicht verbunden = Downloadserver nicht erreichbar / kein Badge = aktuell |
| Einsatzzeitpunkt | Verteilung eines neuen Builds / Einspielen von Bugfixes / Ergänzung neuer Treiber |
Ist AVA_VERSION leer (= Downloadserver nicht erreichbar), erscheint beim Klick auf die Schaltfläche der Dialog Verbindung zum Downloadserver nicht möglich und der Vorgang wird abgebrochen — es wird kein Download versucht, also unbedenklich.
8. Übersicht: Welche Schaltfläche in welcher Situation?
| Symptom / Absicht | Empfehlung |
|---|---|
nur app.properties geändert | 🔁 Anwendung neu starten |
| nach OS-Patch / nach Firmware-Update | 🎬 System-Reboot |
| Datenträger 90 %, rot | 🗑 Temporärdateien bereinigen |
| Umzug der Umgebung / unmittelbar vor Upgrade | ⏱ Backup |
| Anforderung einer Problemanalyse | 📄 Logs herunterladen |
| Verteilung eines neuen Builds | ☁ S/W-Upgrade |
| Sicherheitspatch des Betriebssystems | 🔌 O/S- und Firmware-Upgrade |
9. Zugehörige Dokumente
- Karten- / Aktionsleitfaden des Startbildschirms — Zuordnung der Schnellaktionen bei roter Kartenfarbe
- Backup- / Wiederherstellungsverfahren — Wiederherstellung aus einem Backup
- Systemlog anzeigen (
/system/log/list) — Suche im Bildschirm statt Log-Download - Betrieb — Auf einen Blick — Betriebsskripte aus Sicht der CLI (
bin/*.sh) - Details zu den Betriebsskripten: start.sh / stop.sh / restart.sh / backup.sh / upgrade.sh / clean.sh