帮助中心

Appearance

实时库 5.0.11 升级 5.0.13 操作说明（含 DASS5 / DASSConsole 一体化升级） ​

适用版本：设备端实时库 openPlant 5.0.11，需升级到 5.0.13；DASS5 后端与 DASSConsole 需同步升级到适配 5.0.13 的版本
前提：已能通过控制台登录设备；双机热备（HA）必须先关闭；设备磁盘剩余空间 ≥ 1GB；设备授权有效
说明：本文推荐的「一体化升级」只需一次系统服务导入，即可同时完成实时库、DASS5 后端、DASSConsole（含设备控制台页面）的升级，无需再做「系统升级 + 重启」两步。

一、为什么 5.0.13 要一起升 ​

5.0.13 的适配同时修改了三部分：

组成说明
实时库 openPlant5.0.11 → 5.0.13；镜像配置从文件（replicator.xml）改为实时库在线表
DASS5 后端适配 5.0.13 的在线镜像接口、删除链路、版本上报等
DASSConsole设备控制台页面（镜像表单、配置向导等）随新版适配

如果只升其中一部分，会出现「新实时库 + 旧后端」或「新后端 + 旧实时库」的中间状态，表现为镜像页/删除功能异常，且不易排查。
一体化升级包把三层放在同一个系统服务里，按固定顺序升级，避免现场把顺序做错。

二、升级前检查 ​

  1. 关闭双机热备：控制台「维护 → 双机热备」中确认已关闭（ha_status=false）。升级会停/起后端与实时库，与 HA 切换互相干扰。
  2. 确认磁盘空间：升级包约 110~160MB，升级过程需要约 500MB 以上余量（备份 + 解压）。
  3. 记录当前状态：实时库版本、镜像列表、采集服务列表（升级后逐项核对）。
  4. 不要断电：升级过程中设备会短暂断连（设备本地控制台/页面可能刷新失败），属正常现象。

三、方式一（推荐）：一次导入一体化系统服务包 ​

步骤 1：获取升级包 ​

获取适配当前设备型号/架构的「设备一体化升级」系统服务包，文件名形如：

dass_Update_rtdb-upgrade.v5.0.13.<日期>.linux-amd64.tar.gz

注意：一台设备只能导入与自身 CPU 架构一致的包（linux-amd64 / linux-arm64）。
包内 Version.ini 已声明 cpu_arch，导入错架构的包会被升级服务拒绝，不会写坏设备。

步骤 2：离线导入 ​

在控制台进入【应用管理】→【系统服务】→「离线导入」，选择上一步的升级包并确认。

步骤 3：等待升级完成 ​

导入后系统服务会自动执行，整个过程约 3~6 分钟（含备份、文件安装、两次服务重启），期间：

  • 设备控制台页面可能短时间打不开/提示连接失败，刷新页面即可；
  • 不要断电、不要重复导入。

步骤 4：确认升级结果 ​

升级完成后，检查以下四项：

检查项期望结果
实时库版本控制台「存储管理」显示「实时库 5.0.13」
DASS5 版本设备「系统信息/版本信息」显示本次升级包版本（如 v5.4.0.2026xxxx）
镜像列表数据镜像页的镜像与同步对象数量与升级前一致（升级服务会迁移旧镜像配置）
服务状态采集服务、上传服务、设备控制台均正常运行

如需查看升级明细：控制台【系统服务】→ 找到「实时库升级服务」→「日志」下载查看；
设备端报告文件：/opt/dasserver/server/rtdb-upgrade/upgrade-report.json。

四、方式二（分步，兼容旧流程） ​

如果现场暂时使用旧的「系统升级 + 系统服务导入」两步操作，请严格按以下顺序：

  1. 先做【维护 → 系统升级】，上传 DASS 系统升级包（dass_Update_*.tar.gz）；
  2. 再做【系统服务 → 离线导入】导入实时库升级服务包；
  3. 最后重启设备（或等待升级服务自动重启后端）。

⚠️ 顺序不可颠倒：DASS 系统升级包里自带旧版 openplant/rtnn，如果先升实时库再跑「系统升级」，会把刚升级的 5.0.13 实时库覆盖回旧版本。
一体化升级包已内置正确的顺序，推荐优先使用方式一。

五、升级失败与回退 ​

升级服务会自动分层回滚，并在 upgrade-report.json / last-failure.json 中记录原因：

  • DASS 层失败：自动还原 DASS 文件与数据库，实时库保持原状；
  • 实时库层失败：自动还原实时库配置与 rtnn，已升级好的 DASS 层保留（新 DASS 兼容旧实时库）。

若需人工退回 5.0.11，参考以下步骤（需技术人员操作）：

  1. 停止实时库服务；
  2. 把 openplant/data/<库>/data/archive_cache 移出（5.0.13 格式旧版读不了；旧版会自动重建空缓存，历史归档不受影响）；
  3. 还原升级前的 openplant/config/ 与 openplant/rtnn（升级服务已备份在 server/rtdb-upgrade/backup-<时间>/）；
  4. 启动实时库，确认版本为 5.0.11。

六、注意事项 ​

  1. 双机热备：升级期间必须关闭；两台设备分别升级完成后再开启。
  2. 架构：Version.ini 中 cpu_arch 必须与设备一致；导入错架构包会被拒绝。
  3. 包体积：一体化包包含 DASS 升级包，约 110~160MB，导入耗时比普通系统服务包长。
  4. 镜像：旧镜像配置会自动迁移到 5.0.13 在线镜像；升级后不要手工再导入旧 replicator.xml。
  5. 设备本地屏：升级期间 hmidisplay 可能短暂黑屏/断连，升级完成后自动恢复。

七、常见问题 ​

Q：导入后页面一直转圈/报连接失败？
A：升级过程会重启DASS服务，属正常现象；等待 1~2 分钟后刷新页面。

Q：升级后存储管理仍显示「实时库 未知」？
A：请确认 DASS5 后端已升级到本次升级包版本（一体化升级会自动升级）；老版本后端不返回实时库版本字段。

Q：能在 HA 开启时升级吗？
A：不能。请先关闭 HA，逐台升级，再重新开启。