模块详细手册
PlantPulse 平台由多个独立模块组成。模块和容器不是 1:1 关系 — 六个应用程序各自有一个容器，而数据湖系列在 plantpulse-datalake 容器中协作运行。
数据湖系列集中在独立的顶级章节 数据湖 中 — 包含路径、配置文件、密码更改、管理控制台、pd CLI、运维、组件（storage、messaging、analytics、timeseries、cep、workflow、data-gateway）和常见问题。
模块分类
模块分类
| 分类 | 模块 | 说明 |
|---|---|---|
| 应用程序 | server | Web 控制台、IIoT 引擎、REST API |
| batch | 计划批处理 | |
| data-gateway | 基于 REST 的数据网关 | |
| sql | 已弃用（2026-09-07） — SQL 控制台已并入 data-gateway | |
| datalake-admin-api | 管理控制台后端 + 健康检查 API (4950 / 4949) | |
| warehouse | 基于 Iceberg 的数据仓库 | |
| 处理 | cep | 复杂事件处理 (Esper) |
| plugin | OPC-UA / AAS 工业标准插件 | |
| timeseries | 时序引擎 + 可视化 UI | |
| 消息传递 | messaging | Kafka + MQTT(HiveMQ)。STOMP(ActiveMQ) 已停用 |
| 存储 | storage | Cassandra + PostgreSQL + Valkey + MinIO |
| 分析 | analytics | Spark + Hive + Kyuubi + Gravitino + Hadoop |
| 工作流 | workflow | Temporal + Kestra |
| 数据湖运维 | pd CLI | 启动/停止/重启、配置、节点管理的单一入口 |
| 数据湖运维 | 管理控制台 | 浏览器运维控制台 (4950 / 4949) |
| utilities | setup、backup、recovery、exporter、migrator、mirror-maker、simulator、api、lab |
模块公共结构
每个服务模块遵循公共目录结构和运维界面。
plantpulse-<module>/
├── app/ # 애플리케이션 WAR / JAR
├── bin/
│ ├── start.sh # 포그라운드 시작
│ ├── stop.sh # 정지
│ └── log-viewer.sh # 실시간 로그 (tail -F)
├── server/ 또는 lib/ # 내장 Tomcat 서버 또는 JAR
├── logs/ # system.log (메인 로그)
└── conf/ 또는 config/ # 설정 파일
常见运维命令
在主机上 — 管理整个堆栈 (/opt/kopens/plantpulse-platform-docker/bin/)。
| 任务 | 命令 | 备注 |
|---|---|---|
| 启动全部 | up.sh | 等到就绪。0 = 可用 |
| 停止全部 | down.sh | 反向依赖顺序，保留状态 |
| 重启全部 | restart.sh | drain → 停止 → 启动 → 等待就绪 |
| 重启单个应用 | docker compose -f compose/docker-compose.yml restart <서비스> | 应用各自使用独立容器 |
| 检查状态 | status.sh | 0 = 正常 / 2 = 异常 |
| 查看统一日志 | logs.sh | 无参数时显示全部容器。用 -f 跟踪 |
在数据湖容器内 — 单独管理基础设施组件 (进入 ./shell.sh)。
| 任务 | 命令 |
|---|---|
| 服务状态 | ./pd status [서비스] |
| 重启服务 | ./pd restart <서비스> |
| 渲染配置 | ./pd config render |
| Cassandra 节点 | ./pd node status · ./pd node repair … |
| 诊断 | ./pd doctor |
模块依赖关系
PlantPulse 根据依赖关系顺序分阶段启动。进行模块级重启时需了解依赖关系。
重启注意事项：重启基础设施模块（storage / messaging / analytics）时，必须同时重启所有依赖的应用程序。最安全的做法是在主机上用
bin/restart.sh重启整个堆栈。
端口映射汇总
| 领域 | 端口 | 模块 |
|---|---|---|
| 外部暴露 | 80 / 443 | server (HTTP / HTTPS) |
| 外部暴露 | 7443 | server (管理控制台 HTTPS) |
| 外部暴露 | 4950 | monitor (健康检查，HTTPS) |
| 消息传递 | 9092 / 9093 / 9094 | messaging (Kafka) |
| 消息传递 | 1883 / 1884 | messaging (MQTT) |
| 存储 | 9042 | storage (Cassandra) |
| 存储 | 5432 | storage (PostgreSQL) |
| 存储 | 6379 | storage (Valkey) |
| 存储 | 9000 / 9001 | storage (MinIO) |
| 分析 | 7077 / 4440 | analytics (Spark Master / UI) |
| 分析 | 10000 | analytics (Kyuubi) |
| 分析 | 19001 | analytics (Gravitino) |
| 分析 | 9083 | analytics (Hive Metastore) |
| 时序 | 7800 / 7801 | timeseries (Engine) |
| 时序 | 3000 | timeseries (UI) |
| 工作流 | 7233 / 8233 | workflow (Temporal) |
| 工作流 | 8380 | workflow (Kestra) |
| 处理 | 7400 / 7401 | cep |
| 处理 | 5500 | data-gateway |
| 处理 | 11004 / 11005 | plugin (OPC-UA) |
| 处理 | 8007 / 8090 | plugin (AAS V2 / V3) |
| 应用程序 | 9500 | batch |
| 应用程序 | 9600 | warehouse |
| 应用程序 | 4000 | sql |
详细的全部端口请参考 端口配置信息 页面。
技术支持
模块运维相关咨询，请联系 webmaster@kopens.com。