平台模块详解（摘要）
本页面是 PlantPulse 平台所有模块的摘要目录。每个模块的详细运维手册可在模块详细手册页面中按模块查看。
安装路径
| 环境 | 路径 |
|---|---|
| 二进制安装（推荐标准） | /opt/kopens/plantpulse-platform/ |
| Docker 容器内部 | /opt/kopens/plantpulse-platform/ |
模块目录
应用模块（用户 / 外部系统直接访问）
| 模块 | 端口 | 角色 | 详解 |
|---|---|---|---|
| plantpulse-server | 80, 443, 7443 | 网页控制台 + IIoT 引擎 + REST API | 详解 |
| plantpulse-batch | 9500 | Quartz 调度批处理（聚合、报表） | 详解 |
| plantpulse-data-gateway | 5500 | REST + JDBC 数据网关 | 详解 |
| plantpulse-sql | — | 已弃用（2026-09-07） — SQL 控制台已合并至 data-gateway(5501) | 详解 |
| plantpulse-datalake-admin-api | 4950, 4949 | 管理控制台 + 健康检查 API + Prometheus（至 2026-09-03 为 plantpulse-monitor） | 详解 |
| plantpulse-warehouse | 9600 | Iceberg 数据湖归档 | 详解 |
处理模块
| 模块 | 端口 | 角色 | 详解 |
|---|---|---|---|
| plantpulse-timeseries | 7800, 3000 | 时序引擎 + Grafana UI | 详解 |
| plantpulse-cep | 7400, 7401 | Esper 复杂事件处理 | 详解 |
| plantpulse-plugin | 11004, 8007, 8090 | OPC-UA + AAS 工业标准 | 详解 |
基础设施模块
| 模块 | 端口 | 组件 | 详解 |
|---|---|---|---|
| plantpulse-storage | 9042, 5432, 6379, 9000 | Cassandra + PostgreSQL + Valkey + MinIO | 详解 |
| plantpulse-messaging | 9092, 1883 | Kafka + MQTT(HiveMQ)。STOMP(ActiveMQ) 已停用 | 详解 |
| plantpulse-analytics | 7077, 4440, 10000, 19001 | Spark + Hive + Kyuubi + Gravitino + Hadoop | 详解 |
| plantpulse-workflow | 7233, 8233, 8380 | Temporal + Kestra | 详解 |
运维 / 工具模块
| 模块 | 用途 | 详解 |
|---|---|---|
plantpulse-datalake-cli（pd） | 数据湖启动·停止·重启·配置·节点管理统一入口 CLI | 详解 |
| plantpulse-setup | 站点/资产/标签模型批量注册（CSV） | 详解 |
| plantpulse-backup | pgBackRest + Medusa + Restic 集成备份 | 详解 |
| plantpulse-recovery | 时序数据按周期重新处理 | 详解 |
| plantpulse-exporter | 时序 CSV 导出 + dsbulk | 详解 |
| plantpulse-migrator | Cassandra 服务器间迁移（Spark） | 详解 |
| plantpulse-mirror-maker | Redis → REST 实时复制（HA/DR） | 详解 |
| plantpulse-simulator | 时序数据模拟器（最多 10K MPS） | 详解 |
| plantpulse-api | REST API 客户端 Java 库 | 详解 |
| plantpulse-lab | Jupyter + Metabase 分析环境 | 详解 |
模块通用结构
plantpulse-<module>/
├── app/ # 애플리케이션 WAR / JAR
├── bin/ # start.sh / stop.sh / log-viewer.sh
├── server/ 또는 lib/ # 내장 서버 또는 라이브러리
├── conf/ 또는 config/ # 설정 파일
└── logs/system.log # 메인 로그
模块依赖关系
重启注意：重启基础设施模块（storage / messaging / analytics）时，所有依赖模块也必须一同重启。在主机上使用
bin/restart.sh重启整个堆栈是最安全的做法。
常用运维命令
# 호스트의 단일 진입점
cd /opt/kopens/plantpulse-platform/plantpulse-datalake-cli/bin
./start-daemon.sh # 전체 시작 (백그라운드)
./stop.sh # 전체 정지
./restart.sh # 전체 재시작
./status.sh # 포트 기반 상태 점검
./log-viewer.sh # 통합 로그 뷰어
./restart-<module>.sh # 모듈 단위 재시작