アプリケーション管理 (/ui/apps)
ゲートウェイはPLCデータ収集のほかにも、複数の付属ツール(ダッシュボード、データフロー、モニタリングなど)を併せて運用できます。この画面では、それらツールの状態を一目で確認し、開始/停止/再起動/新規アプリのデプロイまで実行できます。
この画面はhost dockerのコンテナを表示します(/var/run/docker.sock マウントを使用)。
plantpulse-edge 自分自身は self-exclude — 一覧に表示されず、start/stop/delete/
inspect/logs/stats/deploy のすべての動作が IllegalStateException で拒否されます(自分自身を停止したり
削除できないようにするためです)。
plantpulse-edge の再起動はSSHで systemctl restart plantpulse-edge.service
または、ステータスバーの「再起動」ボタン(signal file 経由)。
1. 画面を開く
メイン画面の [アプリケーション] カードをクリックするか、アドレスバーに /ui/apps を直接入力します。
┌────────────────────────────────────────────────────────────┐
│ ⊙ 애플리케이션 — 엣지에 배포된 컨테이너 · 시작/중지/재시작 │
│ [↻ 새로고침] [+ 새 앱 배포] │
├────────────────────────────────────────────────────────────┤
│ ℹ 이 화면에서는 엣지에 설치된 애플리케이션의 현재 상태를 │
│ 한눈에 확인하고, 필요할 때 시작·중지·재시작 할 수 있습니다.│
├────────────────────────────────────────────────────────────┤
│ [앱 카드] [앱 카드] [앱 카드] │
│ [앱 카드] [앱 카드] ... │
└────────────────────────────────────────────────────────────┘
以前のバージョンの ← 戻る ボタンは削除されました — 左サイドバー/ロゴのクリックで他の画面へ移動します。
2. 上部アクション
| ボタン | 動作 |
|---|---|
↻ 更新 (fa-sync) | apps.refresh() — 即座にカードを再描画 |
+ 新規アプリデプロイ (fa-plus) | apps.openDeploy() — 新規コンテナ定義 + 登録モーダル(ユーザー定義イメージ / ポートマッピング / 環境変数) |
画面右上の小さなグレーのラベル(#apps_status_label)に 最終更新時刻 が時折表示され、自動ポーリングが稼働中であることを示します。
3. カード構造
各アプリは角丸カード(20pxラディウス + グレーの枠線)で表現され、ホバー時にわずかに浮き上がります。
| カード項目 | 意味 |
|---|---|
| 左側の大きなアイコン(四角形、light blue背景) | アプリ種別 — コンテナイメージに基づく |
| アプリ名 | Dockerコンテナ名(例: pp-grafana, pp-node-red) |
| 状態バッジ(丸型カプセル) | running(緑) / exited dead restarting(赤) / paused(オレンジ) / created(グレー) |
| イメージ | monoフォント + グレーボックス。使用中のDockerイメージ(例: grafana/grafana:10.3) |
| ポート | クリック → 新しいウィンドウでアプリ画面を自動オープン(例: 3000 → http://게이트웨이:3000/) |
| 作成 | コンテナを作成した時刻 |
| リソース | CPU / メモリ(実行中のアプリのみ、docker stats の結果) |
| アクション領域(カード下部) | [開始] [停止] [再起動] [ログ] ボタン — 状態に応じて有効/無効 |
画面は 10秒ごとに自動更新 — バックエンドの /apps/list を呼び出した後に再描画します。
よく見かける付属アプリ
| ツール | 役割 |
|---|---|
| Grafana | 時系列グラフ / 運用ダッシュボード |
| Node-RED | ノーコードのデータフロー / 自動化 |
| HiveMQ (MQTTブローカー) | メッセージ中継(Sparkplug B の発行先) |
| Cassandra | 時系列ストア |
| Portainer | Dockerコンテナのビジュアル管理ツール |
| Uptime Kuma | シンプルな可用性モニタ(稼働/停止の判定) |
| File Browser | Webファイルマネージャ |
インストールされているアプリは環境ごとに異なります。どのアプリが表示されるかは、システム管理者がIIoTプラットフォームからリモートデプロイした結果です。
よく行う作業
付属アプリの画面を開く
カードの ポート番号をクリック すると、該当アプリの画面が新しいウィンドウで開きます。
- 通常は
http://게이트웨이IP:포트/形式で自動接続されます - アプリごとに独自のログインが必要な場合があります(例: Grafana, Portainer)
付属アプリの開始 / 停止 / 再起動
| 動作 | 方法 | 備考 |
|---|---|---|
| 開始 | カードの[開始]ボタン | 停止状態のときのみ有効 |
| 停止 | カードの[停止]ボタン | 実行中 / 一時停止のときのみ有効 |
| 再起動 | [再起動]ボタン | 常に使用可能 |
確認ダイアログが一度表示されるため、誤って押した場合も[キャンセル]できます。
付属アプリのログ表示
カードの [ログ] ボタン → 最後の200行を黒い画面に表示します。アプリが起動しないときの原因究明や、システム管理者への報告用に使用してください。
更新
左上の[更新]ボタンを押すと即座に更新できます(10秒ごとの自動更新とは別)。
ゲートウェイ自体の管理(ステータスバーのクイックアクション)
画面左下の ステータスバー の7つのアイコンで、ゲートウェイOS / アプリケーション自体を制御します — 全ページ共通。
詳細な動作 / 所要時間 / 注意事項は、別ドキュメント ステータスバーのクイックアクション にまとめています。
| アイコン | 動作 | 備考 |
|---|---|---|
🎬 (fa-projector) システムリブート | OS再起動 | 約3~5分 — 全PLCの収集が中断 |
🔁 (fa-repeat-1-alt) アプリケーション再起動 | Tomcat / ゲートウェイSWのみ再起動 | 1分以内 |
🗑 (fa-trash) 一時ファイルのクリーンアップ | 一時ファイル / キャッシュの整理 | ディスク不足時 |
⏱ (fa-stopwatch) バックアップ | 設定 + DBのバックアップ | バックアップ / リストア |
📄 (fa-file-alt) ログダウンロード | 診断ログのzip | 問題報告時に添付 |
🔌 (fa-microchip) O/S およびファームウェアのアップグレード | ファームウェア更新 | 慎重に |
☁ (fa-cloud-download) S/W アップグレード | ゲートウェイSWの更新 (product.kopens.io) | 右上のバッジ アップグレード可能! が表示されているときのみ有効 |
再起動 / アップグレードの間は PLC値の収集が一時中断 されます。稼働時間外に実施することを推奨します。
ゲートウェイ自体のインストール
システム管理者向け — 新しい環境に初めてインストールする場合。
基本のインストールは通常システム管理者が事前に済ませていますが、新しい環境に初めてインストールする場合は、次のワンライナーコマンドで一括インストールできます。
bash < <(curl -s http://product.kopens.io/plantpulse-edge/install.sh)
内部的にJDK / Tomcat / Cassandra / ゲートウェイをすべてインストールします。
詳細なビルド / デプロイ / 環境設定の手順が必要な場合は、高度な設定 — 設定ファイルガイド および 高度な設定 — 開発者ノート を参照してください。
よくある質問
Q. アプリケーションが「停止」状態なのに開始できません
PCのリソース不足(メモリ不足など)、またはポート競合の可能性があります。
- メイン画面でメモリ / ディスクのゲージを確認
- [設定] → [一時ファイルのクリーンアップ] を試す
- それでも解決しない場合は[ログ]ボタンでエラーメッセージを確認し、システム管理者に伝える
Q. ゲートウェイを再起動するとPLC接続 / タグは消えますか?
いいえ。設定は安全に保存 されているため再起動後に自動的に復元され、「自動開始」に設定したPLCは自動的に収集を再開します。
Q. 付属アプリはゲートウェイと分離して別のPCに置けますか?
可能ですが、推奨構成は同一PCです。システム管理者に相談してください。