跳到主要内容

安装后巡检

完成安装（单行安装, 量产线安装, 隔离网络安装）后，请按照以下顺序将网关切换至 运行准备状态。

1. 1分钟健康检查​

sudo bash /opt/kopens/install/bin/status.sh
curl -ks https://127.0.0.1/api/v1/system/version | python3 -m json.tool
curl -ks https://127.0.0.1/api/v1/system/health | python3 -m json.tool

预期结果：

  • container running + healthy
  • 9个端口 listening (80, 443, 1883, 1884, 6379, 9042, 1880, 12000, 12443) — 7799(Tomcat JMX) 仅在 127.0.0.1 监听
  • /api/v1/system/version → build_date / image_tag / container_mode=true
  • /api/v1/system/health → 200, components 全部 UP

pe-status 若所有项均为 ✓ 则进入下一节。若部分项为 ✗，请参考 容器模式运行 的“故障响应”章节。

在正式投入运行前，请记录 生产验收标准 的 acceptance log。

2. 更改初始密码 — 优先执行​

请勿在未更改安装时创建的凭据情况下投入运行。更改内容及方法请参阅 初始密码更改 — 这是 委任必选 项，且必须在下述备份与镜像操作之前完成。

3. 设置自动备份​

sudo tee /etc/cron.d/plantpulse-edge-backup > /dev/null << 'EOF'
# 매일 새벽 3시 백업 + 일요일 새벽 4시 30일 초과 백업 삭제
0 3 * * * root /opt/kopens/install/bin/backup.sh > /dev/null 2>&1
0 4 * * 0 root find /data1/pp-backups -name 'pe-backup-*.tar.zst' -mtime +30 -delete
EOF

sudo bash /opt/kopens/install/bin/backup.sh
ls -lh /data1/pp-backups/

详情：备份与恢复

4. 外部 NAS / S3 镜像 (灾难恢复)​

如果备份仅保存在与网关相同的磁盘中，则没有 灾难恢复 效果。强烈建议进行外部镜像：

# 컨테이너 백업 예시
LATEST=$(ls -t /data1/pp-backups/pe-backup-*.tar.zst | head -1)
rsync -av "$LATEST" "$LATEST.sha256" nas:/backup/edge/

5. 用户 · 权限设置 (可选)​

除了默认 admin 之外，如果需要 按用户划分的账户：

网关提供了 用户 · 角色 · 菜单访问权限 界面。

界面地址功能
用户管理/system/user创建账户并分配角色
角色管理/system/role定义角色
菜单访问权限/system/menu_access设定每个角色可查看的菜单
场景建议
单人运行使用默认账户并 仅更改密码
多人运行划分账户并分配角色，记录 谁执行了什么操作
外部合作伙伴请先执行以下确认
在向合作伙伴开放之前，请确认«是否实际拦截»

虽然存在保存角色和菜单访问权限的界面与表格，但 建议在安装版本中直接确认该限制在每次请求时是否实际生效。

确认方法 — 创建一个受限角色的账户并 使用该账户登录，尝试点击本应被拦截的菜单（如：删除连接），确认是否确实无法操作。「菜单不可见» 与 «直接输入地址也被拦截» 是不同的。

如果已确定向外部展示的内容，建议使用 平台权限组 仅开放必要项，而非直接开放网关界面。

6. 建议阅读内容​

  1. 主页卡片 / 操作指南 — 30个卡片的含义
  2. 新增 PLC 连接
  3. 标签注册 + PLC 地址输入 (44个驱动完整指南)
  4. Sparkplug B 发布 — 外部 SCADA 联动时
  5. 流程 (Node-RED) — 自动化 / 报警 / 外部集成
  6. 运行概览 — 启动/停止/重启/备份/升级/诊断

7. 验收测试清单 (交付 · SI 合作伙伴用)​

新站点验收时，以下各项必须全部通过：

  • 若为容器模式则 status.sh 全部 OK；若为 native 则确认 bin/ps.sh 5个 Java/Node 进程
  • /api/v1/system/version HTTP 200 + 返回预期的 edge_id/site_id/container_mode
  • /api/v1/system/health HTTP 200 + components UP
  • 生成 生产验收标准 的 acceptance log + 记录 sha256
  • /api/v1/monitoring HTTP 200 + cpu_used_percent < 30%, memory_used_percent < 60%
  • 30个主页卡片全部显示 + 1秒刷新动作
  • 注册 1 个模拟器 OPC → 启动 → /ui/opcua 树中图表正常
  • 注册 1 台实际 PLC → 采集状态 🟢 正常 + 最新值更新
  • 容器 systemctl restart plantpulse-edge.service 或 native bin/restart.sh 后 PLC 自动重新连接 (auto_collect=true)
  • 备份 cron 注册 + 确认首次备份文件/目录已生成
  • 将首次备份的 .tar.zst 与 .sha256 复制到外部备份位置
  • 确认外部 SCADA / Sparkplug 接收端消息到达
  • 完成 密码更改 (更改 admin 默认密码)
  • 确认 /etc/kopens/credentials.txt 权限 0600 root + 完成密码交付流程
  • 使用 log-viewer 监控 30 秒 — 无 SEVERE / ERROR 级日志
  • 磁盘剩余 30%+ (df -h /data1)
  • OS NTP 同步 (timedatectl) 正常
  • 将网关 IP / 访问信息交付运行团队 + 签署移交确认书

深入了解​