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

ステータスバーのクイックアクション (全ページ共通)

ゲートウェイ 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 失敗しモニタ = 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. 関連ドキュメント​