Zum Hauptinhalt springen

plantpulse-plugin (Industriestandard-Plugin)

Rolle​

Plugin zur Anbindung industrieller Standardprotokolle. Ermöglicht externen Systemen / Geräten den Zugriff auf PlantPulse-Daten über eine Industriestandard-Schnittstelle.

ElementWert
Modulnameplantpulse-plugin
Installationspfad/opt/kopens/plantpulse-platform/plantpulse-plugin/
OPC-UA-Port11004 (TCP), 11005 (TLS)
AAS-V2-Port8007
AAS-V3-Port8090

Konfiguration​

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 Tag- und Anlagendaten von PlantPulse extern über den OPC-UA-Standard bereit.

Zentrale Einstellungen​

# 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-Endpunkt-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-Healthcheck​

Der integrierte Browse-UI-HTTP-Server stellt GET /api/health bereit (Port gemäß opc.ua.browser.ui.port-Einstellung, 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)​

Digital-Twin-Schnittstelle nach ISO 23252 / IEC 63278. Exponiert Anlagendaten in einer standardisierten Shell für Industrie 4.0.

VersionPortStandard
V2 (BaSyx)8007Plattform Industrie 4.0 V2
V3 (BaSyx)8090IEC 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​

OPC-UA und AAS laufen jeweils als eigene Container(plantpulse-plugin-opcua · plantpulse-plugin-aasx). Behandeln Sie die Container direkt.

pd status                                 # 포트 표 — 전부 RUNNING 이어야 한다
docker restart plantpulse-plugin-opcua    # OPC-UA 만 재시작
docker restart plantpulse-plugin-aasx     # AAS 만 재시작
docker logs --tail 50 plantpulse-plugin-opcua
Die früheren restart-plugin.sh · restart-opcua-server.sh · restart-aasx-server.sh existieren nicht mehr

Seit das Plugin als unabhängiger Container und nicht mehr als Modul im Data Lake fungiert, sind diese entfallen. Was in plantpulse-datalake-cli/bin/ verbleibt, ist nur noch pd.

Häufig auftretende Probleme​

SymptomUrsacheMaßnahme
OPC-UA-Client-Verbindung schlägt fehlFirewall / ZertifikatPort 11004 + von pd_ssl_prepare ausgestellte OPC-UA-App-URI prüfen → Sicherheitseinstellungen
OPC-UA "Bad Certificate"self-signed-Zertifikat nicht vertrauenswürdigIm Client zu rejected/ → trusted/ wechseln
AAS-Daten nicht aktuellMetadaten-CacheNeustart oder AAS-Registry aktualisieren

Zugehörige Dokumentation​