运维 — 一览
这是通过 SSH 登录网关服务器的管理员(root)所执行的运维脚本集合。普通用户仅使用 Web UI 即可，但启动 / 停止 / 备份 / 升级 / 故障诊断等运维操作需通过这些脚本完成。
容器模式 (2026.05+) 另见专门指南
若 systemctl is-active plantpulse-edge.service 为 active，则为容器模式。
请勿使用本页的 native 脚本 (bin/start.sh 等)，改用 容器模式 页面中的
/opt/kopens/install/bin/*.sh 命令。本页仅适用于 native 部署的机器。
安装路径 (native)：
PE_HOME=/opt/kopens/plantpulse-edge
cd $PE_HOME/bin
ls *.sh # 어떤 스크립트가 있는지 확인
一览
| 分类 | 脚本 | 一句话说明 | 耗时 |
|---|---|---|---|
| 启动 | start.sh | 启动网关整个技术栈 | ~90–120秒 |
start-daemon.sh | 以 nohup 后台方式运行 start.sh | 立即 | |
| 停止 | stop.sh | 按模块全部关闭 (各组件最多 20 秒，含 Cassandra drain) | ~60–90秒 |
| 重启 | restart.sh | 仅重启 Tomcat — 不中断服务，使用最频繁 | ~6秒 |
reboot.sh | 重启操作系统 | — | |
| 备份 | backup.sh | 配置 + DB snapshot + 工具数据一次性备份 | 分钟级 |
| 升级 | 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 磁盘空间 | 分钟级 | |
| 场景 | — | 新版本部署 / 故障诊断 / 磁盘不足 / 定期备份 / 灾难恢复 Runbook | — |
最常用的命令
在开发 / 部署周期中几乎每次都会用到的是 restart.sh (仅 Tomcat，6 秒)。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或脚本顶部的注释。