Schnellaktionen in der Statusleiste
Die Statusleiste unten links auf allen Seiten der Gateway-Web-UI enthält 7 Schnellaktions-Icons. Damit erledigen Bediener häufig genutzte Aufgaben wie das Neustarten des Betriebssystems/der Anwendung, Festplattenbereinigung, Backup oder Upgrade mit einem Klick.
Die Schaltflächen für Neustart / Reboot / Temporäre Bereinigung / Upgrade / Firmware funktionieren im Container-Modus über Signal-Dateien.
Die UI ruft nicht direkt bash-Skripte auf, sondern schreibt /etc/kopens/upgrade.request oder
/etc/kopens/host-action.request, die vom Host-kopens-upgrade.path /
kopens-host-action.path (inotify) erkannt werden, um die entsprechende Aktion auszuführen (Pattern B Sicherheit – damit der Container nicht
Host-Root-Äquivalent wird). Die Ausführungsergebnisse werden in /etc/kopens/upgrade.status / host-action.status
als JSON protokolliert, die die UI per Polling anzeigt.
┌──────────────────────────────────────────────────────────────┐
│ … 페이지 컨텐츠 … │
├──────────────────────────────────────────────────────────────┤
│ KOPENS Edge | 🎬 🔁 🗑 ⏱ 📄 🔌 ☁ | 버전 V2026.05.10 │
└──────────────────────────────────────────────────────────────┘
Beim Klick auf ein Icon erscheint einmal ein Bestätigungsmodul, und Sie müssen [Bestätigen] erneut drücken, um die Aktion auszuführen (Schutz vor Fehlbedienung). Einige Aktionen zeigen zusätzlich ein rotes 〈Achtung〉-Badge, um auf das Risiko hinzuweisen.
1. 🎬 System-Reboot (fa-projector)
Startet das Betriebssystem selbst neu. Die stärkste Aktion – normalerweise nicht verwenden.
| Element | Wert |
|---|---|
| Aufruf | bootbox.confirm → Backend-Reboot-Endpunkt |
| Tatsächliche Aktion | Betriebssystem-reboot |
| Dauer | 3 bis 5 Minuten (BIOS POST + OS-Boot + Tomcat-Boot + Cassandra) |
| PLC-Erfassung | Währenddessen vollständig unterbrochen |
| Externe Verbindung | Die Gateway-IP ist nicht mehr anpingbar, bis der Neustart abgeschlossen ist; danach wieder erreichbar |
| Verwendungszeitpunkt | Nach OS-Patches / Kernel-Modul-Laden / Hardware-Inspektion |
| Warnhinweis | 🔴 Achtung (rotes Badge) |
2. 🔁 Anwendungsneustart (fa-repeat-1-alt)
Startet nur Tomcat (die Gateway-Software) neu. Das OS bleibt unverändert.
| Element | Wert |
|---|---|
| Tatsächliche Aktion | restart.sh (/opt/kopens/plantpulse-edge/bin/restart.sh) |
| Dauer | ca. 30 bis 60 Sekunden |
| PLC-Erfassung | Vorübergehend unterbrochen – automatische Wiederherstellung nach dem Boot |
| Verwendungszeitpunkt | Anwendung von app.properties-Änderungen / erneutes Binden des OPC-UA-Servers / Bereinigung von Speicheransammlungen |
Neustart-Race: In einigen Umgebungen schlägt der ServerStartListener still fehl, sodass monitor=null wird – in diesem Fall führt ein erneuter Aufruf von ./restart.sh (oder ein weiterer Klick auf diese Schaltfläche) zu einem normalen Boot.
3. 🗑 Temporäre Dateien bereinigen (fa-trash)
Entfernt Protokolle/Caches/Upload-Reste, um Festplattenplatz freizugeben.
| Element | Wert |
|---|---|
| Tatsächliche Aktion | clean.sh (beschränkt auf Arbeitsverzeichnis-Prefixe des Gateways mit hoher Festplattennutzung) |
| Dauer | Einige Sekunden bis einige zehn Sekunden |
| PLC-Erfassung | Keine Auswirkung (nur Dateibereinigung) |
| Verwendungszeitpunkt | Wenn die Festplatte-Karte auf dem Hauptbildschirm über 90 % liegt / direkt vor einem Upgrade / nach längerem Betrieb |
Wenn die Festplatte-Karte auf dem Startbildschirm rot ist, ist diese Schaltfläche die erste Maßnahme.
4. ⏱ Backup (fa-stopwatch)
Sichert die Gateway-Konfiguration und Betriebsdaten in einer Backup-Datei.
| Element | Wert |
|---|---|
| Tatsächliche Aktion | backup.sh |
| Ergebnis | /opt/kopens/.../backup/<timestamp>.tar.gz |
| Umfang | app.properties, einige Cassandra-Keyspaces, Node-RED userDir, OPC-/Tag-Definitionen |
| Wiederherstellung | Backup / Wiederherstellung – separates Verfahren |
| Verwendungszeitpunkt | Direkt vor einem Upgrade / Umgebungsmigration / regelmäßiges Backup |
5. 📄 Protokoll herunterladen (fa-file-alt)
Lädt sofort ein Diagnose-Logpaket herunter.
| Element | Wert |
|---|---|
| Aufruf | location.href = "/log-download" (GET-Anfrage, Server streamt ZIP) |
| Ergebnis | Zip-Datei mit den neuesten Gateway-Protokollen und Diagnoseinformationen |
| Verwendungszeitpunkt | Anhang bei Problemmeldung an Systemadministratoren / Anfrage zur Ursachenanalyse |
Zum Durchsuchen von Protokollinhalten ist die Systemprotokoll-Ansicht (
/system/log/list) bequemer – Filterung nach Zeitraum/Stufe/Suchbegriff möglich.
6. 🔌 O/S- und Firmware-Upgrade (fa-microchip)
Upgrade des Betriebssystems / BIOS / Geräte-Firmware. Die riskanteste Aktion.
| Element | Wert |
|---|---|
| Tatsächliche Aktion | OS-Paketmanager + Firmware-Update-Skripte des Herstellers |
| Dauer | Einige Minuten bis mehrere zehn Minuten |
| PLC-Erfassung | Währenddessen vollständig unterbrochen |
| Externe Verbindung | In einigen Phasen unterbrochen |
| Warnhinweis | 🔴 Achtung (rotes Badge) |
| Verwendungszeitpunkt | Sicherheitsupdates / Herstellerempfehlung / KOPENS-Hinweis |
Das Firmware-Upgrade kann nicht rückgängig zu machende Schritte enthalten. Führen Sie es unbedingt außerhalb der Betriebszeiten durch und erstellen Sie zuerst ein Backup (Nr. 4).
7. ☁ Software-Upgrade (fa-cloud-download)
Lädt die Gateway-Software (diese Web-UI) vom Download-Server herunter und führt das Upgrade durch.
| Element | Wert |
|---|---|
| Download-Server | product.kopens.io (oder interner Mirror) |
| Tatsächliche Aktion | upgrade.sh – Neuen Build herunterladen → SHA256-Verifizierung → Swap → Neustart |
| Dauer | 1 bis 3 Minuten (Downloadgeschwindigkeit + Neustart) |
| PLC-Erfassung | Vorübergehende Unterbrechung von unter 1 Minute |
| Badge oben rechts | Rotes Upgrade verfügbar! = neue Version auf dem Download-Server / Graues Nicht verbunden = Download-Server nicht erreichbar / kein Badge = aktuell |
| Verwendungszeitpunkt | Bereitstellung eines neuen Builds / Anwendung von Bugfixes / Hinzufügen neuer Treiber |
Wenn AVA_VERSION leer ist (= Download-Server nicht erreichbar), öffnet sich beim Klick auf die Schaltfläche das Modal Download-Server kann nicht verbunden werden und die Aktion wird abgebrochen – es wird kein neuer Download versucht, daher sicher.
8. Übersicht: Welche Schaltfläche in welcher Situation?
| Symptom / Absicht | Empfehlung |
|---|---|
Nur app.properties geändert | 🔁 Anwendungsneustart |
| Nach OS-Patch / Firmware-Update | 🎬 System-Reboot |
| Festplatte 90 % rot | 🗑 Temporäre Dateien bereinigen |
| Umgebungsmigration / direkt vor Upgrade | ⏱ Backup |
| Anforderung einer Problemanalyse | 📄 Protokoll herunterladen |
| Bereitstellung eines neuen Builds | ☁ Software-Upgrade |
| Betriebssystem-Sicherheitspatch | 🔌 O/S- und Firmware-Upgrade |
9. Zugehörige Dokumentation
- Startbildschirm-Karten / Aktionsleitfaden – Zuordnung zu Schnellaktionen, wenn Kartenfarben rot sind
- Backup- / Wiederherstellungsverfahren – Wiederherstellung von Backup-Ergebnissen
- Systemprotokoll anzeigen (
/system/log/list) – Statt Protokoll herunterzuladen, direkt im Bildschirm suchen - Betriebsübersicht – Betriebsskripte aus CLI-Sicht (
bin/*.sh) - Details zu Betriebsskripten: start.sh / stop.sh / restart.sh / backup.sh / upgrade.sh / clean.sh