运营概览
您想做什么
| 想要做的事 | 阅读内容 |
|---|---|
| 开启/关闭 · 重启 | 启动 · 停止 · 重启 |
| 查看状态 · 监控 | 监控 |
| 备份 · 恢复 | 备份 |
| 更改密码 · 密钥 | 凭据 |
| 无法正常工作时排查 | 诊断 |
| 按情况应对 | 运营场景 |
| 直接操作容器时 | 容器运营 |
| 表 · 架构 | 数据库模型 |
| 双机热备 | HA |
| 版本升级 | 升级 |
| 磁盘清理 | 清理 |
这是通过 SSH 连接到网关服务器后由管理员(root) 执行的运营脚本集。普通用户仅使用 Web UI 即可，但启动 / 停止 / 备份 / 升级 / 故障诊断等运营操作需通过这些脚本执行。
容器模式 (2026.05+) 请参考单独指南
systemctl is-active plantpulse-edge.service 为 active 时采用容器模式。
请使用**容器模式运营** 页面中的 /opt/kopens/install/bin/*.sh 命令，而不是本页的 native 脚本 (bin/start.sh 等)。本页面仅适用于 native 部署环境。
安装路径 (native):
PE_HOME=/opt/kopens/plantpulse-edge
cd $PE_HOME/bin
ls *.sh # 어떤 스크립트가 있는지 확인
一览
| 分类 | 脚本 | 一句话说明 | 耗时 |
|---|---|---|---|
| 启动 | start.sh | 启动网关 整体栈 | ~90–120秒 |
start-daemon.sh | 将 start.sh 以 nohup 后台运行 | 立即 | |
| 停止 | stop.sh | 按模块完全停止 (各组件最长20秒，包含 Cassandra drain) | ~60–90秒 |
| 重启 | restart.sh | 将 stop.sh + start.sh 作为一个进程 — 整体栈 | ~150–210秒 |
restart-app.sh | 仅重启 Tomcat(应用) — 屏幕上的「应用重启」即为此操作 | 30–90秒 | |
reboot.sh | 操作系统重启 | — | |
| 备份 | backup.sh | 配置 + 数据库快照 + 工具数据一次性备份 | 分钟级 |
| 升级 | upgrade.sh | 备份 → 下载/安装新版本 | 5–15分钟 |
firmware.sh | 操作系统包更新 (dnf update) | 分钟级 | |
| 诊断 | log-viewer.sh | 7个组件日志整合 tail -f | 无限 |
ps.sh | 存活的 plantpulse 进程 | 立即 | |
node-info.sh | nodetool info (Cassandra 状态) | 立即 | |
node-cql.sh | Cassandra cqlsh 交互式 | — | |
network-speed-test.sh | 外部网络速度测量 | 分钟级 | |
| 清理 | clean.sh | 批量删除日志 / 临时文件 | 立即 |
node-cleanup.sh | 回收 Cassandra 磁盘空间 | 分钟级 | |
| 场景 | — | 新版本部署 / 故障诊断 / 磁盘不足 / 定期备份 / 灾难恢复操作手册 | — |
最常用的命令
在开发/部署周期中几乎每次都会用到的是 restart-app.sh (仅应用，30~90秒)。start.sh 仅在操作系统重启后执行一次，stop.sh 仅在巡检·备份前使用。
子组件自身的 start.sh / stop.sh
整体脚本 (start.sh, stop.sh) 仅负责协调顺序，内部实现由各组件脚本负责。当只想重启某一个时，可直接调用：
| 组件 | 启动 | 停止 |
|---|---|---|
| Redis (cache) | $PE_HOME/cache/bin/start.sh | $PE_HOME/cache/bin/stop.sh |
| Cassandra (DB) | $PE_HOME/db/bin/start.sh | $PE_HOME/db/bin/stop.sh |
| HiveMQ (MQTT) | $PE_HOME/mqtt/bin/start.sh | $PE_HOME/mqtt/bin/stop.sh |
| timeseries-engine | $PE_HOME/timeseries/engine/bin/start.sh | $PE_HOME/timeseries/engine/bin/stop.sh |
| timeseries-dashboard | $PE_HOME/timeseries/dashboard/bin/start.sh | $PE_HOME/timeseries/dashboard/bin/stop.sh |
| Tomcat (server) | $PE_HOME/server/bin/start.sh | $PE_HOME/server/bin/stop.sh |
| Node-RED | $PE_HOME/node/bin/start.sh | $PE_HOME/node/bin/stop.sh |
示例 — 仅重启 Node-RED:
$PE_HOME/node/bin/stop.sh
$PE_HOME/node/bin/start.sh
权限 / 位置参考
- 所有脚本都需要 root 权限 (绑定端口 80/443、systemctl、写入 /opt/)。
- 目录：
| 用途 | 路径 |
|---|---|
| 网关代码 / 产物 | /opt/kopens/plantpulse-edge/ |
| 用户数据 (sparkplug bdSeq, grafana, node-red, hivemq, apm) | /data1/pp-data/ |
| 备份产物 | /data1/pp-backup/ |
| Tomcat 日志 | $PE_HOME/server/logs/catalina.out |
| Cassandra 日志 | $PE_HOME/db/logs/system.log |
| HiveMQ 日志 | $PE_HOME/mqtt/log/hivemq.log |
| Node-RED 日志 | $PE_HOME/node/log/node-red.log |
- 注意：建议将
/opt/kopens/和/data1/pp-data/放置在独立磁盘上。代码更新与数据保留分离，可降低升级时数据丢失的风险。
了解更多
- 各类别的详细步骤，请参阅左侧菜单中的启动 / 停止 / 重启 / 备份 / 升级 / 诊断 / 清理 / 场景页面。
- 各脚本的使用方法请参考
--help或脚本顶部的注释。