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 (ポート 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 エンドポイント URL:
opc.tcp://[HOST]:11004(なし)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":...}
運用コマンド
cd /opt/kopens/plantpulse-platform/plantpulse-datalake-cli/bin
./restart-plugin.sh # 플러그인 전체 재시작
./restart-opcua-server.sh # OPC-UA 만 재시작
./restart-aasx-server.sh # AAS 만 재시작
./status.sh # 11004 / 8007 / 8090 RUNNING 확인
よくある問題
| 症状 | 原因 | 対処 |
|---|---|---|
| OPC-UA クライアント接続失敗 | ファイアウォール / 証明書 | 11004 ポート + prepare-ssl.sh の OPC-UA app URI を確認 |
| OPC-UA "Bad Certificate" | 自己署名証明書が信頼されていない | クライアントで rejected/ → trusted/ に移動 |
| AAS データが反映されない | メタデータキャッシュ | 再起動または AAS Registry を更新 |