Platform Modules at a Glance
This page is a summary catalog of all modules that make up the PlantPulse platform. Detailed operation manuals for each module are available by module on the Module Reference page.
Installation Paths
| Environment | Path |
|---|---|
| Binary installation (recommended standard) | /opt/kopens/plantpulse-platform/ |
| Inside Docker container | /opt/kopens/plantpulse-platform/ |
Module Catalog
Application Modules (direct access by users / external systems)
| Module | Port | Role | Details |
|---|---|---|---|
| plantpulse-server | 80, 443, 7443 | Web console + IIoT engine + REST API | Details |
| plantpulse-batch | 9500 | Quartz scheduled batch (aggregation, reporting) | Details |
| plantpulse-data-gateway | 5500 | REST + JDBC data gateway | Details |
| plantpulse-sql | — | Deprecated (2026-09-07) — SQL console merged into data-gateway(5501) | Details |
| plantpulse-datalake-admin-api | 4950, 4949 | Admin console + health API + Prometheus (until 2026-09-03 plantpulse-monitor) | Details |
| plantpulse-warehouse | 9600 | Iceberg lakehouse archiving | Details |
Processing Modules
| Module | Port | Role | Details |
|---|---|---|---|
| plantpulse-timeseries | 7800, 3000 | Time series engine + Grafana UI | Details |
| plantpulse-cep | 7400, 7401 | Esper CEP | Details |
| plantpulse-plugin | 11004, 8007, 8090 | OPC-UA + AAS industrial standards | Details |
Infrastructure Modules
| Module | Port | Components | Details |
|---|---|---|---|
| plantpulse-storage | 9042, 5432, 6379, 9000 | Cassandra + PostgreSQL + Valkey + MinIO | Details |
| plantpulse-messaging | 9092, 1883 | Kafka + MQTT(HiveMQ). STOMP(ActiveMQ) is retired | Details |
| plantpulse-analytics | 7077, 4440, 10000, 19001 | Spark + Hive + Kyuubi + Gravitino + Hadoop | Details |
| plantpulse-workflow | 7233, 8233, 8380 | Temporal + Kestra | Details |
Operations / Utility Modules
| Module | Purpose | Details |
|---|---|---|
plantpulse-datalake-cli (pd) | Single entry point CLI for data lake startup, shutdown, restart, configuration, and node management | Details |
| plantpulse-setup | Bulk registration of site/asset/tag models (CSV) | Details |
| plantpulse-backup | Integrated backup: pgBackRest + Medusa + Restic | Details |
| plantpulse-recovery | Time series data reprocessing by period | Details |
| plantpulse-exporter | Time series CSV extraction + dsbulk | Details |
| plantpulse-migrator | Cassandra cross-server migration (Spark) | Details |
| plantpulse-mirror-maker | Redis → REST real-time replication (HA/DR) | Details |
| plantpulse-simulator | Time series data simulator (up to 10K MPS) | Details |
| plantpulse-api | REST API client Java library | Details |
| plantpulse-lab | Jupyter + Metabase analytics environment | Details |
Module Common Structure
plantpulse-<module>/
├── app/ # 애플리케이션 WAR / JAR
├── bin/ # start.sh / stop.sh / log-viewer.sh
├── server/ 또는 lib/ # 내장 서버 또는 라이브러리
├── conf/ 또는 config/ # 설정 파일
└── logs/system.log # 메인 로그
Module Dependencies
Restart caution: Restarting infrastructure modules (storage / messaging / analytics) requires restarting all dependent applications as well. It is safest to restart the entire stack using
bin/restart.shon the host.
Common Operations Commands
# 호스트의 단일 진입점
cd /opt/kopens/plantpulse-platform/plantpulse-datalake-cli/bin
./start-daemon.sh # 전체 시작 (백그라운드)
./stop.sh # 전체 정지
./restart.sh # 전체 재시작
./status.sh # 포트 기반 상태 점검
./log-viewer.sh # 통합 로그 뷰어
./restart-<module>.sh # 모듈 단위 재시작
Related Documentation
- Module Reference Index — In-depth manuals by module
- Startup Guide — Daily operations commands
- Operations Management — Backup / update / removal
- Ports and Service Management — Port mapping
- Developers: Module Descriptions — Developer perspective