管理员指南
您想执行什么操作
| 操作目标 | 查阅位置 |
|---|---|
| 开关机 · 重启 | 启动与停止 |
| 查看状态 · 监控 | 监测 |
| 执行备份与恢复演练 | 备份与恢复 |
| 更改密码 · API 密钥 | 凭据轮换 |
| 用户 · 权限管理 | 用户管理 |
| 安全检查 | 安全 |
| 运行缓慢时 | 性能调优 |
| 虚拟标签计算未运行时 | 虚拟标签运行 |
| 数据累积量 · 删除时间 | 数据保留政策 |
| 防火墙开放端口 | 端口 |
| OEE · RAM · EMS 数值混淆时 | OEE · RAM · EMS 常见问题 |
| 查找设定值时 | 属性参考 |
| 查看表 · 模式时 | 数据库模型 |
| 冗余配置 | HA |
| 版本升级 — 流程 | 升级 |
| 版本升级 · 联动变更项 | 升级日志 |
| 模块划分详情 | 模块详情 · 下方模块图 |
模块图
PlantPulse Platform 由多个独立模块组成。模块与容器并非 1:1 关系 — 应用程序类模块各自拥有独立容器，而数据湖系列则在 plantpulse-datalake 一个容器内共同运行。
数据湖系列汇总在独立的顶层章节 数据湖 中 — 涵盖路径 · 配置文件 · 密码更改 · 管理控制台 · pd CLI · 运行 · 组件 (storage · messaging · analytics · timeseries · cep · workflow · data-gateway) · FAQ。
模块分类
模块类别
| 类别 | 模块 | 说明 |
|---|---|---|
| 应用程序 | server | Web 控制台, IIoT 引擎, REST API |
| batch | 调度批处理 | |
| data-gateway | 基于 REST 的数据网关 | |
| datalake-admin-api | 管理控制台后端 + 状态 API (4950 / 4949) | |
| warehouse | 基于 Iceberg 的数据仓库 | |
| 处理 | cep | 复杂事件处理 (Aster CEP) |
| plugin | OPC-UA / AAS 工业标准插件 | |
| timeseries | 时序引擎 + 可视化 UI | |
| 消息传递 | messaging | Kafka + MQTT(HiveMQ)。STOMP(ActiveMQ) 已停用 |
| 存储 | storage | Aster TSDB + PostgreSQL + Valkey + RustFS |
| 分析 | 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 |
| Aster TSDB 节点 | ./pd node status · ./pd node repair … |
| 诊断 | ./pd doctor |
模块依赖关系
PlantPulse 按照依赖顺序分阶段启动。在进行模块级重启时，必须了解依赖关系。
重启注意事项: 重启基础设施模块 (storage / messaging / analytics) 时，所有依赖这些模块的应用程序也必须同步重启。最安全的方法是在宿主机上使用
bin/restart.sh重启整个堆栈。
端口映射摘要
| 区域 | 端口 | 模块 |
|---|---|---|
| 外部暴露 | 80 / 443 | server (HTTP / HTTPS) |
| 外部暴露 | 4950 | monitor (健康检查, HTTPS) |
| 消息传递 | 9092 / 9093 / 9094 | messaging (Kafka) |
| 消息传递 | 1883 / 1884 | messaging (MQTT) |
| 存储 | 9042 | storage (Aster TSDB) |
| 存储 | 5432 | storage (PostgreSQL) |
| 存储 | 6379 | storage (Valkey) |
| 存储 | 9000 / 9001 | storage (RustFS) |
| 分析 | 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。