Skip to main content

plantpulse-plugin (Industrial Standard Plugin)

Role​

Industrial standard protocol integration plugin. Enables external systems and equipment to access PlantPulse data through industry standard interfaces.

ItemValue
Module Nameplantpulse-plugin
Installation Path/opt/kopens/plantpulse-platform/plantpulse-plugin/
OPC-UA Port11004 (TCP), 11005 (TLS)
AAS V2 Port8007
AAS V3 Port8090

Architecture​

Directory Structure​

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)​

Exposes PlantPulse tags and asset data to external systems in OPC-UA standard format.

Core Configuration​

# 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 Connection​

OPC-UA Endpoint URL:

  • opc.tcp://[HOST]:11004 (None)
  • opc.tcp://[HOST]:11005 (Basic256Sha256, TLS)

Validated OPC-UA clients:

  • UaExpert (Unified Automation)
  • Prosys OPC UA Browser
  • Node-RED node-red-contrib-opcua

Standard Health Check​

The embedded Browse UI HTTP server provides GET /api/health (port is opc.ua.browser.ui.port configuration, default 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 interface compliant with ISO 23252 / IEC 63278 standards. Exposes asset data in standardized shell format for Industrie 4.0.

VersionPortStandard
V2 (BaSyx)8007Plattform Industrie 4.0 V2
V3 (BaSyx)8090IEC 63278 V3

API Endpoints​

# 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":...}

Operations Commands​

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 확인

Troubleshooting​

SymptomCauseAction
OPC-UA client connection failsFirewall / certificateVerify port 11004 + OPC-UA app URI in prepare-ssl.sh
OPC-UA "Bad Certificate"Self-signed certificate not trustedMove from rejected/ → trusted/ on client
AAS data not reflectingMetadata cacheRestart or refresh AAS Registry