Web UI 環境設定
ゲートウェイの設定（Edge識別・OPC UA・データ収集・実行モード・Platform・AI・HA）を
Webで編集する画面です。値は最終的に app.properties に保存されます。
1. 画面構成 — 7つのタブ形式フォーム
ゲートウェイ設定を 項目別フォーム で編集する画面です。各項目の意味やデフォルト値が 入力欄の下に記載されています。
| 番号 | 位置 | 機能 |
|---|---|---|
| ① | 最上部 | 注意パネル — 再起動の必要性・必須キー・Web 접속不可時の対処 |
| ② | その下 | 7つのタブ — Edge・OPC UAサーバー・データ収集・実行モード・Platform / API・AIアシスタント・HA (二重Edge) |
| ③ | 右上 | 保存 — 現在のタブだけでなく すべての値 を保存します |
| ④ | 本文 | グループヘッダー — 1つのタブ内がさらにいくつかのグループに分かれています |
| ⑤ | 各行 | ラベル・入力欄・ 説明とデフォルト値 |
| ⑥ | 下方向 | グループが続きます (PLC収集機・診断・REST API認証 …) |
以前は app.properties の原文を CodeMirror で一括編集する画面でした。現在は
項目別フォーム となっており、キーを直接入力することはありません。ファイルを直接編集する必要があるのは
Web画面が表示されない時 のみであり、その際の編集箇所は注意パネルに記載された
/opt/kopens/plantpulse-edge/conf/app.properties です。
ホームカード 環境設定 → クリック、または /ui/system/config。
2. タブ別項目
Edge
| グループ | 項目 |
|---|---|
| Edge識別 | edge.id · edge.site_id · データ保存期間(edge.ttl) · 24/7運用(edge.always-on) · Platformコールバックアドレス(edge.base_url) |
| 管理者アカウント | edge.admin_login_id · edge.admin_password |
| 初期登録 (CSV) | edge.init — 起動時に /ui/connect/csv に配置されたOPC・タグCSVを自動登録 |
| PLC収集機 | 収集スレッド数 · 強制接続リセット(ms) · 接続警告(ms) · アドレススキャン警告(ms) · アドレスマップスキャン警告(ms) |
| 診断 | edge.diagnostic.send.enabled — Platform診断サーバーへ定期送信 |
| REST API認証 | edge.rest.api.auth · edge.rest.api.key |
空欄にした場合、 LAN1 → LAN2 → ホスト名 の順で自動決定されます。NAT配下にある場合や管理網を 別途利用する場合のみ明示してください。ドメイン・ホスト名も指定可能ですが、Platformは プライベートIPのみ 証明書 検証を緩和しているため、名前で指定すると自己署名証明書によるTLSエラーでブロックされる可能性があります。
OPC UA サーバー
Edgeが 外部に提供する OPC UA サーバーです（外部SCADAが接続する側）。 ドメイン・TCPポート・TLSポート・ユーザー・パスワード・匿名接続許可・セキュリティなしエンドポイント。
データ収集
| グループ | 項目 |
|---|---|
| MQTTパブリッシャー | mqtt.enable · ホスト · ポート · ユーザー · パスワード · トピック |
| Sparkplug B | sparkplug.enable · グループ ID · Edgeノード ID · デバイス戦略 · QoS · bdSeqパス · エイリアス使用 · コマンド受信(sparkplug.cmd.enable) |
実行モード
dev.mode のみです — EDGE(Platform接続) / STANDALONE(未接続) の2種類のみ です。
PLATFORM を入力すると起動が停止します。
Platform / API
Platformサーバー接続 — ホスト・ポート・SSL・ APIキー ・メッセージング使用有無およびブローカーアドレス。
このタブには 接続テスト ボタンがあります。画面説明通り「保存せず 現在画面に入力された値 でPlatform /api/v5 への接続を試行します」。ping は認証不要のため、
APIキーまで同時に検証 されます。これにより、誤ったキーで保存して再起動した後に不具合に気づく事態を防げます。
AI アシスタント
| グループ | 項目 |
|---|---|
| AIインファレンス API | ai.enabled · ai.api.base_url · ai.model · ai.api.key |
| チューニング | ai.max_tool_steps · ai.timeout_ms · ai.bulk_read_limit |
詳細は AI エッジアシスタント を参照してください。
HA (二重 Edge)
| グループ | 項目 |
|---|---|
| HAペア | ha.peer.enabled · 相手ホスト · 確認周期(ms) |
| PLC書き込み権限 | edge.plc.write_authority |
3. 保存と反映
保存 は、現在表示しているタブだけでなく すべてのタブの値 をまとめて書き込みます
(POST /config/save)。保存は即時に行われますが、 ランタイムへの反映は再起動後 となります。
1. [저장] → 토스트 "재시작 필요"
2. 외부 SCADA / Sparkplug 수신측에 점검 공지 (앱만 재시작해도 30~90초는 끊깁니다)
3. 재시작 (/config/restart 또는 bin/restart.sh)
4. 1–2초 대기 → 화면 새로고침 → /api/v1/edge 로 새 값 확인
アプリのみを再起動すればよい項目は restart-app.sh
(30~90秒) で十分です。DB / MQTT まで再起動が必要な項目（例：mqtt.enable トグル）は
全体再起動 が必要です。
画面の警告通りです — 「必須キーを空にするか、誤った値で保存すると 次回起動に失敗 する可能性があります」。Web画面が表示されない場合は SSH でログインし、
/opt/kopens/plantpulse-edge/conf/app.properties を直接修正して bin/restart.sh。
コンテナモード(2026.05+)では、保存時に /etc/kopens/app.properties(ホストバインドマウント)が
更新され、コンテナの再起動で適用されます。HiveMQブローカーの auth.properties は
entrypointが起動のたびに mqtt.server.* と自動同期されるため、 手動で変更する必要はありません。
CLIでも実行可能です。
sudo bash /opt/kopens/install/bin/config.sh --set edge.rest.api.auth true
sudo bash /opt/kopens/install/bin/config.sh --restart
4. よくあるトラブル
| 症状 | 原因 / 解決策 |
|---|---|
| 保存はしたが変更が反映されない | 再起動していない。bin/restart.sh を呼び出すこと |
| 保存後、Webにアクセスできない | 必須値が空であるか、形式が崩れている。SSHで手動復旧 |
| Platformに接続できない | まず 接続テスト を押してください — ホスト・ポート・SSL・APIキーを一度に検証できます |
| 保存直後にトースト通知が出ない | 通信エラー → ネットワーク / Tomcatの状態を確認 (bin/ps.sh) |
すべてのキー一覧とデフォルト値は app.properties リファレンス にあります。
5. システムタグ (自動登録 / 90000–90037)
ゲートウェイ起動時、自身のシステム接続(OPC_SYSTEM_<edge_id>)と38個のシステムタグ(TAG_<edge_id>_90000 ~ _90037)をOPC-UAサーバーに自動登録します。外部SCADA / IIoT側でこれらのタグを購読することで、ゲートウェイの 状態/識別/ネットワーク 情報を直接取得できます。
5.1 識別 / ネットワーク (90000–90006)
| インデックス | メトリック | タイプ | 意味 |
|---|---|---|---|
| 90000 | HOSTNAME | STRING | Edgeボックスのホスト名 |
| 90001 | VERSION | STRING | Edge SWバージョン |
| 90002 | NET_1_IP | STRING | ネットワークポート 1 IP |
| 90003 | NET_2_IP | STRING | ネットワークポート 2 IP |
| 90004 | NET_WIFI_IP | STRING | Wi-Fi IP |
| 90005 | NET_VPN_IP | STRING | VPN IP |
| 90006 | PING | BOOLEAN | Platform到達可否 |
5.2 リソース (90007–90011)
| インデックス | メトリック | タイプ | 意味 |
|---|---|---|---|
| 90007 | CPU_USED_PERCENT | DOUBLE | CPU使用率 (%) |
| 90008 | MEMORY_USED_PERCENT | DOUBLE | メモリ使用率 (%) |
| 90009 | DISK_USED_PERCENT | DOUBLE | ディスク使用率 (%) |
| 90010 | NETWORK_RX_BYTES | LONG | ネットワーク受信バイト |
| 90011 | NETWORK_TX_BYTES | LONG | ネットワーク送信バイト |
5.3 収集 / 送信 / システム (90012–90027)
| インデックス | メトリック | タイプ | 意味 |
|---|---|---|---|
| 90012 | PLC_CON_CONNECTED_COUNT | LONG | 接続済み接続数 |
| 90013 | PLC_CON_DISCONNECTED_COUNT | LONG | 切断済み接続数 |
| 90014 | PLC_VALUE_READ_SUCCESS_COUNT | LONG | タグ読み取り成功件数 |
| 90015 | PLC_VALUE_READ_ERROR_COUNT | LONG | タグ読み取り失敗件数 |
| 90016 | SENDED_POINT_COUNT | LONG | Platformへ送信したポイント数 |
| 90017 | SENDED_POINT_BYTES | LONG | Platformへ送信したバイト数 |
| 90018 | MPS | LONG | 秒当たり処理ポイント数 |
| 90019 | TEMPERATURE | INT | デバイス温度 |
| 90020 | OPC_COUNT | INT | 登録済み接続数 |
| 90021 | TAG_COUNT | INT | 登録済みタグ数 |
| 90022 | SERVER_STARTED_TIMESTAMP | LONG | Edge起動時刻 (epoch ms) |
| 90023 | PLC_PING_FAILED_COUNT | INT | pingに応答しないデバイス数 |
| 90024 | SYSTEM_DB_TTL | INT | ローカルデータ保存期間 (TTL) |
| 90025 | SYSTEM_TOTAL_DB_SIZE | LONG | ローカルDBサイズ |
| 90026 | SYSTEM_ERROR_COUNT | LONG | Edgeエラー件数 |
| 90027 | THREAD_COUNT | LONG | JVMスレッド数 |
5.4 運用 / 識別 (90028–90037)
| インデックス | メトリック | タイプ | 意味 |
|---|---|---|---|
| 90028 | CONNECTED_OPC_IDS | STRING | 接続済み接続IDリスト |
| 90029 | API_KEY | STRING | REST APIキー箇所。 値は常にマスキング(******)され、実際のキーは送信されません |
| 90030 | REGISTED_OPC_IDS | STRING | 登録済み接続IDリスト |
| 90031 | DISCONNECTED_OPC_IDS | STRING | 切断済み接続IDリスト |
| 90032 | COLLECTING_OPC_IDS | STRING | 収集中の接続IDリスト |
| 90033 | STOPPED_OPC_IDS | STRING | 収集停止中の接続IDリスト |
| 90034 | BUILD_DATE | STRING | Edgeビルド日 |
| 90035 | DOCKER_CONTAINER_NAMES | STRING | 実行中のDockerコンテナ |
| 90036 | NET_MGNT_IP | STRING | 管理ネットワーク IP |
| 90037 | NET_GSM_IP | STRING | セルラー(GSM) IP |
タイプはスキーマタイプです。CPU・メモリ・ディスク使用率およびネットワークバイトは INT として発行されます。システムタグは10秒周期で
SendTaskが更新します。外部SCADAでこれを購読すれば、 現場に行かずとも Edgeの状態を一目で把握できるダッシュボードを構築できます。
6. さらに詳しく
- すべてのキーの意味: app.properties リファレンス
- 変更後の再起動: 再起動 (
restart.sh) - バックアップ後の変更: バックアップ (
backup.sh) - システムログでの変更検証: システムログ表示
- REST API認証 / キー発行: REST API ガイド