Status Bar Quick Actions (Common to All Pages)
The status bar at the bottom left of every page in the gateway web UI provides seven quick action icons. They let you restart the OS/application or perform frequently used operator tasks — disk cleanup, backup, upgrade — with a single click.
The restart / reboot / temp cleanup / upgrade / firmware buttons operate via signal files in container mode.
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 executes as the corresponding action (Pattern B security — so that the container does not become
host root equivalent). Execution results are recorded in /etc/kopens/upgrade.status / host-action.status
JSON, which the UI displays by polling.
┌──────────────────────────────────────────────────────────────┐
│ … 페이지 컨텐츠 … │
├──────────────────────────────────────────────────────────────┤
│ KOPENS Edge | 🎬 🔁 🗑 ⏱ 📄 🔌 ☁ | 버전 V2026.05.10 │
└──────────────────────────────────────────────────────────────┘
Each icon opens a confirmation modal once when pressed, and requires another click on [Confirm] to execute (to prevent accidental operation). Some actions also display a red 〈Caution〉 badge to indicate their risk level.
1. 🎬 System Reboot (fa-projector)
Reboots the OS itself. This is the most drastic action — do not use it routinely.
| Item | Value |
|---|---|
| Call | bootbox.confirm → backend reboot endpoint |
| Actual behavior | OS reboot |
| Duration | 3 to 5 minutes (BIOS POST + OS boot + Tomcat startup + Cassandra) |
| PLC collection | Fully stopped during this time |
| External access | Disconnected until the gateway IP stops responding to ping, then restored after boot |
| When to use | After OS patching / kernel module loading / 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 suspended, then automatically restored after startup |
| When to use | Applying app.properties changes / rebinding the OPC-UA server / clearing accumulated memory |
Restart race: In some environments, ServerStartListener fails silently and the monitor ends up null — in that case, call ./restart.sh once more (or click this button again) and it will start up normally.
3. 🗑 Temporary File Cleanup (fa-trash)
Deletes leftover logs/caches/uploads to free up disk space.
| Item | Value |
|---|---|
| Actual behavior | clean.sh (cleanup limited to gateway working directory prefixes with high disk usage) |
| Duration | A few seconds to a few tens of seconds |
| PLC collection | No impact (file cleanup only) |
| When to use | When the Disk card on the main screen exceeds 90% / just before an upgrade / after long-running operation |
When the Disk card on the home screen is red, this button is the first response.
4. ⏱ Backup (fa-stopwatch)
Saves the gateway's configuration + operational data to a backup file.
| Item | Value |
|---|---|
| Actual behavior | backup.sh |
| Output | /opt/kopens/.../backup/<timestamp>.tar.gz |
| Scope | app.properties, selected Cassandra keyspaces, Node-RED userDir, OPC/tag definitions |
| Restore method | Backup / Restore — separate procedure |
| When to use | Just before an upgrade / environment migration / scheduled backup |
5. 📄 Log Download (fa-file-alt)
Immediately downloads a diagnostic log bundle.
| Item | Value |
|---|---|
| Call | location.href = "/log-download" (GET request, zip streamed from the server) |
| Output | Recent gateway logs + diagnostic information zip |
| When to use | Attaching to a problem report for the system administrator / requesting root cause analysis |
For searching log contents, System Log Viewer (
/system/log/list) is more convenient — it supports filtering by period, level, and search term.
6. 🔌 O/S 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 several tens of minutes |
| PLC collection | Fully stopped during this time |
| External access | Disconnected during some stages |
| Caution label | 🔴 Caution (red badge) |
| When to use | Security patches / vendor recommendations / KOPENS notices |
Firmware upgrades may include stages that cannot be rolled back. Always perform them outside operating hours, and take a backup (item 4) first.
7. ☁ S/W Upgrade (fa-cloud-download)
Downloads the gateway SW (this web UI) from the download server and upgrades it.
| Item | Value |
|---|---|
| Download server | product.kopens.io (or an internal mirror) |
| Actual behavior | upgrade.sh — download new build → SHA256 verification → swap → restart |
| Duration | 1 to 3 minutes (download speed + restart) |
| PLC collection | Suspended for less than 1 minute |
| Top-right badge | Red Upgrade available! = a new version exists on the download server / Gray Not connected = failed to reach the download server / no badge = up to date |
| When to use | New build deployment / applying bug fixes / adding new drivers |
If AVA_VERSION is empty (= the download server is unreachable), clicking the button opens a Cannot connect to the download server modal and aborts — no new download is attempted, so it is safe.
8. Summary: Which button for which situation?
| Symptom / Intent | Recommendation |
|---|---|
Only changed app.properties | 🔁 Application Restart |
| After OS patching / firmware application | 🎬 System Reboot |
| Disk red at 90% | 🗑 Temporary File Cleanup |
| Environment migration / just before upgrade | ⏱ Backup |
| Requesting problem analysis | 📄 Log Download |
| New build deployment | ☁ S/W Upgrade |
| OS security patch | 🔌 O/S and Firmware Upgrade |
9. Related Documents
- Home Screen Card / Action Guide — mapping to quick actions when a card turns red
- Backup / Restore Procedure — how to restore from a backup
- System Log Viewer (
/system/log/list) — search on screen instead of downloading logs - Operations — At a Glance — operational scripts from the CLI (
bin/*.sh) perspective - Operational script details: start.sh / stop.sh / restart.sh / backup.sh / upgrade.sh / clean.sh