Status Bar Quick Actions
The gateway web UI has 7 quick action icons in the status bar at the bottom left of every page. They provide one-click access to operations that operators frequently use, such as reloading the OS/application, or performing disk cleanup, backup, and upgrades.
In container mode, the Restart / Reboot / Temp Cleanup / Upgrade / Firmware buttons operate via signal files.
Instead of the UI calling bash scripts directly, it writes /etc/kopens/upgrade.request or
/etc/kopens/host-action.request, which the host's kopens-upgrade.path /
kopens-host-action.path (inotify) detects and then executes the corresponding action (Pattern B security — ensuring the container
does not gain host root privileges). The execution results are recorded in the /etc/kopens/upgrade.status / host-action.status
JSON, which the UI then displays via polling.
┌──────────────────────────────────────────────────────────────┐
│ … 페이지 컨텐츠 … │
├──────────────────────────────────────────────────────────────┤
│ KOPENS Edge | 🎬 🔁 🗑 ⏱ 📄 🔌 ☁ | 버전 V2026.05.10 │
└──────────────────────────────────────────────────────────────┘
Each icon, when pressed, will first display a confirmation modal, and the action is only executed once you press [Confirm] again (to prevent accidental operation). Some actions also display a red 〈Caution〉 badge to indicate danger.
1. 🎬 System Reboot (fa-projector)
This reboots the OS itself. It is the strongest action — do not use it under normal circumstances.
| Item | Value |
|---|---|
| Call | bootbox.confirm → Backend reboot endpoint |
| Actual Behavior | Operating system reboot |
| Duration | 3 to 5 minutes (BIOS POST + OS boot + Tomcat boot + Cassandra) |
| PLC Collection | Completely stopped during this period |
| External Connections | Disconnected until the gateway IP stops responding, then returns after boot |
| Use Cases | After OS patching / kernel module loading / after hardware inspection |
| Caution Label | 🔴 Caution (red badge) |
2. 🔁 Application Restart (fa-repeat-1-alt)
Restarts only Tomcat (the gateway SW). The OS stays up.
| Item | Value |
|---|---|
| Actual Behavior | restart.sh (/opt/kopens/plantpulse-edge/bin/restart.sh) |
| Duration | About 30 to 60 seconds |
| PLC Collection | Temporarily paused — automatically recovers after boot |
| Use Cases | Applying app.properties changes / OPC-UA server rebinding / clearing accumulated memory |
Restart race: In some environments, ServerStartListener fails silently, causing monitor=null. In this case, calling ./restart.sh one more time (or clicking this button again) will result in a successful boot.
3. 🗑 Temporary File Cleanup (fa-trash)
Frees up disk space by deleting logs, caches, and upload remnants.
| Item | Value |
|---|---|
| Actual Behavior | clean.sh (limited cleanup of gateway working directory prefixes that are using high disk space) |
| Duration | A few seconds to tens of seconds |
| PLC Collection | No impact (file cleanup only) |
| Use Cases | When the main screen Disk card exceeds 90% / right before an upgrade / after prolonged operation |
When the Home Screen Disk card is red, this button is the first line of defense.
4. ⏱ Backup (fa-stopwatch)
Backs up the gateway configuration and operational data to a backup file.
| Item | Value |
|---|---|
| Actual Behavior | backup.sh |
| Output | /opt/kopens/.../backup/<timestamp>.tar.gz |
| Scope | app.properties, certain Cassandra keyspaces, Node-RED userDir, OPC/tag definitions |
| How to Restore | Backup / Restore — separate procedure |
| Use Cases | Right before an upgrade / environment migration / scheduled backups |
5. 📄 Download Logs (fa-file-alt)
Immediately downloads a bundle of diagnostic logs.
| Item | Value |
|---|---|
| Call | location.href = "/log-download" (GET request, zip streamed from server) |
| Output | A zip of recent gateway logs and diagnostic info |
| Use Cases | Attaching to a problem report to a system administrator / requesting root cause analysis |
For searching within log content, the System Log Viewer (
/system/log/list) is more convenient — you can filter by time period, level, or search text.
6. 🔌 OS and Firmware Upgrade (fa-microchip)
Upgrades the operating system / BIOS / device firmware. The highest-risk action.
| Item | Value |
|---|---|
| Actual Behavior | OS package manager + vendor firmware update script |
| Duration | Several minutes to tens of minutes |
| PLC Collection | Completely stopped during this period |
| External Connections | Interrupted at certain stages |
| Caution Label | 🔴 Caution (red badge) |
| Use Cases | Security patches / vendor recommendations / KOPENS notifications |
Firmware upgrades can include steps that cannot be rolled back. Always proceed during scheduled maintenance windows, and ensure you have made a backup (Step 4) first.
7. ☁ S/W Upgrade (fa-cloud-download)
Upgrades the gateway SW (the web UI) from the download server.
| Item | Value |
|---|---|
| Download Server | product.kopens.io (or an in-house mirror) |
| Actual Behavior | upgrade.sh — download new build → SHA256 verification → swap → restart |
| Duration | 1 to 3 minutes (download speed + restart) |
| PLC Collection | Paused for up to 1 minute |
| Top-right Badge | Red Upgrade available! = a new version exists on the download server / Gray Unreachable = cannot reach the download server / No badge = up-to-date |
| Use Cases | New build deployment / bug fix implementation / adding new drivers |
If AVA_VERSION is empty (meaning the download server is unreachable), clicking the button displays a Cannot connect to download server modal and exits — it will not attempt a new download, making it safe.
8. Summary: Which Button to Use, When?
| Symptom / Intent | Recommendation |
|---|---|
Only changed app.properties | 🔁 Application Restart |
| After OS patch / firmware update | 🎬 System Reboot |
| Disk at 90% (red) | 🗑 Temporary File Cleanup |
| Before environment migration / upgrade | ⏱ Backup |
| Requesting problem analysis | 📄 Download Logs |
| New build deployment | ☁ S/W Upgrade |
| OS security patching | 🔌 OS and Firmware Upgrade |
9. Related Documentation
- Home Screen Cards / Action Guide — Mapping for when card colors turn red and how to use quick actions
- Backup / Restore Procedure — How to restore from a backup
- System Log Viewer (
/system/log/list) — Search logs on screen instead of downloading them - Operations Overview — Operational scripts from a CLI (
bin/*.sh) perspective - Operational Script Details: start.sh / stop.sh / restart.sh / backup.sh / upgrade.sh / clean.sh