plantpulse-plugin (産業標準プラグイン)
役割
産業標準プロトコル連携プラグイン。外部システム / デバイスが PlantPulse のデータに産業標準インターフェースでアクセスできるようにします。
| 項目 | 値 |
|---|---|
| モジュール名 | plantpulse-plugin |
| インストールパス | /opt/kopens/plantpulse-platform/plantpulse-plugin/ |
| OPC-UA ポート | 11004 (TCP)、11005 (TLS) |
| AAS V2 ポート | 8007 |
| AAS V3 ポート | 8090 |
構成
ディレクトリ構造
plantpulse-plugin/
├── opc-ua/ # OPC-UA 서버
│ ├── bin/start.sh stop.sh log-viewer.sh
│ ├── config/
│ │ ├── server.properties
│ │ └── address-space.xml
│ ├── lib/
│ └── logs/system.log
└── aasx-server/ # AAS (Asset Administration Shell)
├── bin/
├── config/
│ ├── BaSyx-V2.cfg
│ └── BaSyx-V3.cfg
├── lib/
└── logs/
OPC-UA Server (port 11004)
PlantPulse のタグ / 資産データを OPC-UA 標準で外部に公開します。
主要設定
# opc-ua/config/server.properties
opcua.server.port=${PP_OPCUA_TCP_PORT}
opcua.server.tls.port=${PP_OPCUA_TLS_PORT}
opcua.server.app.uri=${PP_TLS_OPCUA_APP_URI}
opcua.server.product.name=PlantPulse OPC-UA Server
opcua.security.policy=Basic256Sha256,None
opcua.security.user.token=Username,Anonymous
opcua.user=opcua
opcua.password=설치-시-변경
opcua.cassandra.host=${PP_CASSANDRA_HOST}
opcua.cassandra.keyspace=${PP_KEYSPACE}
クライアント接続
OPC-UA Endpoint URL:
opc.tcp://[HOST]:11004(None)opc.tcp://[HOST]:11005(Basic256Sha256, TLS)
検証済み OPC-UA クライアント:
- UaExpert (Unified Automation)
- Prosys OPC UA Browser
- Node-RED
node-red-contrib-opcua
標準ヘルスチェック
内蔵 Browse UI HTTP サーバーが GET /api/health を提供します (ポートは opc.ua.browser.ui.port 設定、デフォルト 12780):
curl -fsS http://127.0.0.1:12780/api/health
# → {"status":"UP","service":"plantpulse-plugin-opcua-server","ts":...}
AAS Server (Asset Administration Shell)
ISO 23252 / IEC 63278 標準のデジタルツインインターフェース。Industrie 4.0 で資産データを標準化されたシェルとして公開します。
| バージョン | ポート | 標準 |
|---|---|---|
| V2 (BaSyx) | 8007 | Plattform Industrie 4.0 V2 |
| V3 (BaSyx) | 8090 | IEC 63278 V3 |
API エンドポイント
# V2
curl http://[HOST]:8007/registry/api/v1/registry
# V3
curl http://[HOST]:8090/api/v3.0/shells
# V3 표준 헬스체크 (익명, 순수 liveness)
curl http://[HOST]:8090/api/health
# → {"status":"UP","service":"plantpulse-plugin-aasx-server","ts":...}
運用コマンド
OPC-UA と AAS はそれぞれ自己コンテナ(plantpulse-plugin-opcua · plantpulse-plugin-aasx)
で起動しています。コンテナを直接扱ってください。
pd status # 포트 표 — 전부 RUNNING 이어야 한다
docker restart plantpulse-plugin-opcua # OPC-UA 만 재시작
docker restart plantpulse-plugin-aasx # AAS 만 재시작
docker logs --tail 50 plantpulse-plugin-opcua
以前の
restart-plugin.sh · restart-opcua-server.sh · restart-aasx-server.sh はありませんプラグインがデータレイク内のモジュールではなく独立コンテナになったため廃止されました。
plantpulse-datalake-cli/bin/ に残っているのは pd のみです。
よくある問題
| 症状 | 原因 | 対応 |
|---|---|---|
| OPC-UA クライアント接続失敗 | ファイアウォール / 証明書 | 11004 ポート + pd_ssl_prepare が発行した OPC-UA app URI を確認 → セキュリティ設定 |
| OPC-UA "Bad Certificate" | self-signed 証明書が信頼されていない | クライアントで rejected/ → trusted/ に移動 |
| AAS データが反映されない | メタデータキャッシュ | 再起動または AAS Registry 更新 |