본문으로 건너뛰기

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

관련 문서​