plantpulse-plugin (Industriestandardplugin)
Rolle
Integrations-Plugin für Industriestandardprotokolle. Ermöglicht es externen Systemen und Geräten, über Industriestandardschnittstellen auf PlantPulse-Daten zuzugreifen.
| Element | Wert |
|---|---|
| Modulname | plantpulse-plugin |
| Installationspfad | /opt/kopens/plantpulse-platform/plantpulse-plugin/ |
| OPC-UA Port | 11004 (TCP), 11005 (TLS) |
| AAS V2 Port | 8007 |
| AAS V3 Port | 8090 |
Aufbau
Verzeichnisstruktur
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)
Stellt die Tags und Anlagedaten von PlantPulse im OPC-UA Standard für externe Systeme zur Verfügung.
Wesentliche Konfiguration
# 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}
Client-Verbindung
OPC-UA Endpoint-URL:
opc.tcp://[HOST]:11004(None)opc.tcp://[HOST]:11005(Basic256Sha256, TLS)
Verifizierte OPC-UA Clients:
- UaExpert (Unified Automation)
- Prosys OPC UA Browser
- Node-RED
node-red-contrib-opcua
Standard-Integritätsprüfung
Der integrierte Browse-UI HTTP-Server stellt GET /api/health zur Verfügung (Port wird in opc.ua.browser.ui.port konfiguriert, Standard 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 Standardschnittstelle für digitale Zwillinge. Stellt Anlagedaten in Industrie 4.0 als standardisierte Shell zur Verfügung.
| Version | Port | Standard |
|---|---|---|
| V2 (BaSyx) | 8007 | Plattform Industrie 4.0 V2 |
| V3 (BaSyx) | 8090 | IEC 63278 V3 |
API-Endpunkte
# 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":...}
Betriebsbefehle
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 확인
Häufig auftretende Probleme
| Symptom | Ursache | Behebung |
|---|---|---|
| OPC-UA Client-Verbindung fehlgeschlagen | Firewall / Zertifikat | Port 11004 + OPC-UA App-URI in prepare-ssl.sh prüfen |
| OPC-UA „Bad Certificate" | Self-signed-Zertifikat nicht vertraut | Auf dem Client in rejected/ zu trusted/ navigieren |
| AAS-Daten nicht aktualisiert | Metadaten-Cache | Neustart oder AAS Registry-Aktualisierung |