运维场景（操作手册）

整理了常见 整体运维流程 的可直接执行手册。按顺序从上到下复制/执行每一节即可。

如果是容器模式盒子，请看其他页面

如果 systemctl is-active plantpulse-edge.service 是 active，则为容器模式 — 请查看容器模式运维而非本页。故障处理、OTA、命令速查都在那里。

盒子里不预装手册。 安装时放在 /opt/kopens/install/ 的只有 upgrade.sh 和 kopens-host-action.sh，以及 bin/ 的运维脚本。文档以本网站为准。

本页为原生盒子场景。

1. 新版本发布 — 最安全的流程

# 0. 작업 공지 (관제 / Slack)
echo "[$(date +%F\ %T)] 게이트웨이 업그레이드 시작 — 약 15분 소요"

# 1. 사전 백업 (자동 backup 도 있지만 수동으로 한 번 더)
$PE_HOME/bin/backup.sh

# 2. 외부 NAS / S3 로 즉시 미러
LATEST=$(ls -t /data1/pp-backup | head -1)
rsync -av /data1/pp-backup/$LATEST nas:/backup/edge/

# 3. 업그레이드 (자동으로 backup → install → start)
$PE_HOME/bin/upgrade.sh

# 4. 검증
$PE_HOME/bin/ps.sh
curl -s http://127.0.0.1/api/v1/edge | jq                       # 버전 확인
curl -s http://127.0.0.1/ui/opcua/tree | jq '.data.tree | length'  # 사이트/태그 정상
$PE_HOME/bin/log-viewer.sh                                       # 30초 정도 봐서 SEVERE 없는지
# (Ctrl+C)

# 5. 외부 SCADA / Sparkplug 수신측 정상 도착 여부 확인
echo "[$(date +%F\ %T)] 업그레이드 완료"

详情: 升级 (upgrade.sh), 备份 (backup.sh)

2. 紧急情况下的快速重启

$PE_HOME/bin/restart-app.sh
# 30~90초 후
curl -s http://127.0.0.1/api/v1/edge | jq

由于仅重新启动应用(Tomcat)，Cassandra · HiveMQ · Node-RED 保持运行。配置更改也会一并生效。如需重启整个栈，请使用 restart.sh。

详情: 重启 (restart.sh)

3. 故障诊断 — 逐步进行

# 1. 누가 죽었나?
$PE_HOME/bin/ps.sh

# 2. 어디가 시끄러운가?
$PE_HOME/bin/log-viewer.sh
# (실시간 — Ctrl+C 로 빠져나옴)

# 3. Cassandra 의심
$PE_HOME/bin/node-info.sh

# 4. Disk 의심
df -h /data1
du -sh $PE_HOME/*/log/* /data1/* 2>/dev/null | sort -h | tail -20

# 5. 다 안 맞으면 — 안전하게 단계적 재시작
$PE_HOME/bin/restart-app.sh       # 1차: 앱(Tomcat)만 — 30~90초
# 그래도 이상 시
$PE_HOME/bin/restart.sh           # 2차: 전체 스택 (stop + start 를 한 프로세스로)
# 그래도 이상 시
sudo $PE_HOME/bin/reboot.sh       # 3차: OS 재부팅 (최후의 수단)

详情: 诊断和巡检

4. 磁盘空间不足应对

# 1. 무엇이 차지 중?
df -h
du -sh $PE_HOME/*/log/* /data1/* 2>/dev/null | sort -h | tail -20

# 2. 로그 / 임시 파일 정리
$PE_HOME/bin/clean.sh

# 3. Cassandra 디스크 회수
$PE_HOME/bin/node-cleanup.sh

# 4. 오래된 백업 정리 (30 일 이상)
find /data1/pp-backup -maxdepth 1 -type d -mtime +30 -exec rm -rf {} +

# 5. 결과 확인
df -h

详情: 清理

5. 定期备份自动化 (cron 示例)

# /etc/cron.d/plantpulse-backup
# 매일 새벽 1시에 백업, 30일 이상은 자동 삭제
0 1 * * * root /opt/kopens/plantpulse-edge/bin/backup.sh >>/var/log/pp-backup.log 2>&1
30 1 * * * root find /data1/pp-backup -maxdepth 1 -type d -mtime +30 -exec rm -rf {} +

应用 cron 后的第二天凌晨1点，请确认 /data1/pp-backup/<date>/ 是否已新生成。

详情: 备份 (backup.sh)

6. OS 安全补丁（每季度）

# 1. 사전 백업
$PE_HOME/bin/backup.sh

# 2. 게이트웨이 정지 (커널 업데이트 가능성 대비)
$PE_HOME/bin/stop.sh

# 3. OS 업데이트
$PE_HOME/bin/firmware.sh

# 4. 커널 업데이트 시 재부팅 필요
needs-restarting -r
# 결과가 "Reboot is required" 이면
$PE_HOME/bin/reboot.sh
# 부팅 후 ssh 다시 들어가서
$PE_HOME/bin/start.sh

# 5. 검증
$PE_HOME/bin/ps.sh

详情: 升级 (upgrade.sh / firmware.sh)

7. 停电 / OS 重启后

虽然可能通过 systemd 注册实现自动启动，但请手动巡检:

$PE_HOME/bin/ps.sh
# 출력이 비어있거나 일부만 살아있다면
$PE_HOME/bin/start.sh
# 또는 백그라운드로
$PE_HOME/bin/start-daemon.sh

详情: 启动 (start.sh)

8. 从备份恢复（灾难恢复）

恢复会覆盖数据 — 请与有经验者一同操作

以下是 整体恢复 的概要说明。请勿在运营环境中直接复制执行，务必与运营团队一起进行。

详细步骤: 备份 (backup.sh) — 从备份恢复

9. 了解更多

各脚本的详细说明，请见左侧菜单: 启动 / 停止 / 重启 / 备份 / 升级 / 诊断 / 清理
所有脚本一览: 运维概览

1. 新版本发布 — 最安全的流程​

2. 紧急情况 下的快速重启​

3. 故障诊断 — 逐步进行​

4. 磁盘空间不足应对​

5. 定期备份自动化 (cron 示例)​

6. OS 安全补丁（每季度）​

7. 停电 / OS 重启后​

8. 从备份恢复（灾难恢复）​

9. 了解更多​