メインコンテンツまでスキップ

ステータスバー クイックアクション

ゲートウェイWeb UI の 全ページ左下ステータスバー に7つのクイックアクションアイコンがあります。OS/アプリケーションを再起動したり、ディスククリーンアップ / バックアップ / アップグレードなど、オペレーターがよく使う操作をワンクリックで実行します。

コンテナモード (2026.05+) の内部動作

再起動 / リブート / 一時クリーンアップ / アップグレード / firmware ボタンは、コンテナモードでは signal ファイル で動作します。 UI が直接 bash スクリプトを呼び出さず、/etc/kopens/upgrade.request または /etc/kopens/host-action.request を作成すると、ホストの kopens-upgrade.path / kopens-host-action.path (inotify) が検知して該当アクションを実行します (Pattern B セキュリティ — コンテナが host root 等価にならないように)。実行結果は /etc/kopens/upgrade.status / host-action.status JSON に記録され、UI が polling で表示します。

┌──────────────────────────────────────────────────────────────┐
│ … 페이지 컨텐츠 …                                              │
├──────────────────────────────────────────────────────────────┤
│ KOPENS Edge  | 🎬 🔁 🗑 ⏱ 📄 🔌 ☁  | 버전 V2026.05.10        │
└──────────────────────────────────────────────────────────────┘

各アイコンを押すと 確認モーダル が一度表示され、[確認] をもう一度押すと実行されます (誤操作防止)。一部のアクションには 赤〈注意〉バッジ が併せて表示され、危険度を知らせます。

1. 🎬 システムリブート (fa-projector)​

OS 自体 を再起動します。最も強いアクション — 通常時は使用しないでください。

項目値
呼び出しbootbox.confirm → バックエンド reboot エンドポイント
実際の動作オペレーティングシステム reboot
所要時間3 ~ 5 分 (BIOS POST + OS ブート + Tomcat ブート + Cassandra)
PLC 収集その間 完全停止
外部接続ゲートウェイ IP への ping が通らなくなるまで切断され、ブート後に復帰
使用時点OS パッチ後 / カーネルモジュールロード / ハードウェア点検後
注意ラベル🔴 注意 (赤バッジ)

2. 🔁 アプリケーション再起動 (fa-repeat-1-alt)​

Tomcat (ゲートウェイ SW) のみ 再起動します。OS はそのまま。

項目値
実際の動作restart.sh (/opt/kopens/plantpulse-edge/bin/restart.sh)
所要時間約 30 ~ 60 秒
PLC 収集その間一時停止 — ブート後に自動復旧
使用時点app.properties 変更適用 / OPC-UA サーバ再バインド / メモリ蓄積クリーンアップ

再起動 race: 一部環境で ServerStartListener が silently 失敗し monitor=null になる場合 — このときはもう一度 ./restart.sh を呼び出す (またはこのボタンをもう一度クリック) と正常にブートします。

3. 🗑 一時ファイルクリーンアップ (fa-trash)​

ログ/キャッシュ/アップロード残骸を削除して ディスク空き容量 を確保します。

項目値
実際の動作clean.sh (ディスク使用量が高いゲートウェイ作業ディレクトリ prefix 限定でクリーンアップ)
所要時間数秒 ~ 数十秒
PLC 収集影響なし (ファイル整理のみ)
使用時点メイン画面 ディスク カードが 90% 超のとき / アップグレード直前 / 長期稼働後
関連カード

ホーム画面 ディスク カード が赤のとき、このボタンが一次対応です。

4. ⏱ バックアップ (fa-stopwatch)​

ゲートウェイの 設定 + 運転データ をバックアップファイルに保存します。

項目値
実際の動作backup.sh
成果物/opt/kopens/.../backup/<timestamp>.tar.gz
含まれる範囲app.properties、Cassandra 一部キースペース、Node-RED userDir、OPC/タグ定義
復旧方法バックアップ / 復元 — 別手順
使用時点アップグレード直前 / 環境移行 / 定期バックアップ

5. 📄 ログダウンロード (fa-file-alt)​

診断用ログ一式を即座にダウンロードします。

項目値
呼び出しlocation.href = "/log-download" (GET リクエスト、サーバーから zip ストリーミング)
成果物最近のゲートウェイログ + 診断情報 zip
使用時点システム管理者への問題報告時の添付 / 原因分析依頼

ログ本文の検索は システムログ表示 (/system/log/list) の方が便利です — 特定期間/レベル/検索語フィルターが可能。

6. 🔌 O/S およびファームウェアアップグレード (fa-microchip)​

オペレーティングシステム / BIOS / デバイスファームウェアをアップグレードします。最も危険度の高いアクション。

項目値
実際の動作OS パッケージマネージャー + ベンダーファームウェア更新スクリプト
所要時間数分 ~ 数十分
PLC 収集その間 完全停止
外部接続一部段階で切断
注意ラベル🔴 注意 (赤バッジ)
使用時点セキュリティパッチ / ベンダー推奨 / KOPENS 案内
元に戻せない段階があります

ファームウェアアップグレードには ロールバック不可能な段階 が含まれる場合があります。必ず運転時間外に実施し、バックアップ (4番) を先に取得しておいてください。

7. ☁ S/W アップグレード (fa-cloud-download)​

ゲートウェイ SW (この Web UI) をダウンロードサーバーから取得してアップグレードします。

項目値
ダウンロードサーバーproduct.kopens.io (または社内ミラー)
実際の動作upgrade.sh — 新ビルドダウンロード → SHA256 検証 → swap → restart
所要時間1 ~ 3 分 (ダウンロード速度 + restart)
PLC 収集1 分以内の一時停止
右上バッジ赤 アップグレード可能! = ダウンロードサーバーに新バージョンあり / グレー 接続なし = ダウンロードサーバーへのアクセス失敗 / バッジなし = 最新
使用時点新ビルド配布 / バグ修正適用 / 新ドライバ追加
ダウンロードサーバー未接続

AVA_VERSION が空の場合 (= ダウンロードサーバーに到達できない)、ボタンクリック時に ダウンロードサーバーに接続できません モーダルが表示され強制終了します — 新規ダウンロードを試みないため安全です。

8. 整理: どの状況でどのボタン?​

症状 / 意図推奨
app.properties だけ変更した🔁 アプリケーション再起動
OS パッチ後 / ファームウェア適用後🎬 システムリブート
ディスク 90% 赤🗑 一時ファイルクリーンアップ
環境移行 / アップグレード直前⏱ バックアップ
問題分析依頼📄 ログダウンロード
新ビルド配布☁ S/W アップグレード
オペレーティングシステムセキュリティパッチ🔌 O/S およびファームウェアアップグレード

9. 関連ドキュメント​