升级与回滚

在系统设置里查看当前版本,用在线更新或历史版本完成升级与降级;设备访问不了发布源时,用安装器的模块包离线安装,失败时回到升级前的版本。

  • 进阶
  • 动手约 20 分钟
  • 阅读 4 分钟
  • 更新于 2026-11-09

视频教程 · 灵犀·Studio 从入门到精通 · 第 12 集 3:49

北向集成、权限与运维升级

你将完成

读完本篇你将完成:

  • 在页面上确认当前版本、最新版本和运行平台;
  • 完成一次在线升级,或在版本历史里升级 / 降级到指定版本;
  • 知道失败时系统会自动回滚,以及什么时候要改用安装器模块包。

开始之前

升级时实际发生什么#

升级前检查、备份、安装、自检,失败则回滚先核对版本并做标准备份,再安装新版本,起来后做健康自检。自检或替换失败时自动回到升级前的版本。1升级前检查看当前版本选低峰时段2先做备份标准备份即可降级前必做3安装在线或模块包勿中途关机4自检服务重新起来页面能登录5失败回滚回到升级前服务恢复可用自检通过即完成。替换、启动或健康检查失败时,系统自动走第 5 步。页面更新只重启灵犀·Studio 服务;采集引擎是否重启取决于所装模块。
图 1 先检查、再备份,安装后自检;失败则回到升级前的版本

页面里的 系统更新 会停掉并重启 灵犀·Studio 服务,同时替换页面文件。确认框写明:更新期间服务暂时不可用,通常 2~5 分钟,低配设备可能更久;页面会短暂连不上,属于正常现象,不要关闭页面,也不要重启设备。新版本如果启动失败,系统自动回滚到当前版本。

这次页面更新不会停止采集引擎。服务重启的那几分钟里,浏览器里的监控、下发、告警通知和历史入库会暂停;采集引擎与现场设备的连接保持,服务恢复后页面重新接上。

用安装器安装某一个模块时,只重启对应的服务:backend 重启灵犀·Studio 服务,web 重启页面,edgeserver 重启采集引擎,sidecar 重启配置生成服务。dotnet 运行时变更会同时重启采集引擎和配置生成服务。

升级前检查#

看当前版本#

打开 系统管理 → 系统设置 → 系统更新。顶部状态卡给出三列:当前版本、最新版本、运行平台(操作系统 / 架构)。

系统更新顶部:当前版本、最新版本和运行平台
  1. 1看当前版本
  2. 2看运行平台

截图里的版本号来自开发环境

开发机构建可能显示一串提交号(例如带 dirty)。按安装包装好的设备上,这里是发布版本号,运行平台是 windows 或 linux 加架构。看的是这三列,不是某一台机器上的具体字符串。

状态卡下方有两个页签:在线更新、手动更新 / 降级。

先备份,再选时段#

  1. 按备份与恢复做一份 标准备份,需要连同历史曲线一起带走时再选完整备份;
  2. 安排在没有人正在改采集配置、没有人依赖画面操作设备的时段;
  3. 降级一定要先备份。确认框会提示:降级可能丢失新版本引入的数据结构或配置。

页面提示不支持在线自更新时

若新版本卡片上出现「当前运行平台不支持在线自更新」,不要反复点 立即更新。改用下面的安装器模块包。

在线升级#

确认新版本并开始#

在线更新 页签在进入页面时会自动检查发布源。

  • 已是最新:显示 已是最新版本,可点 重新检查;
  • 有新版本:卡片列出版本号、发布时间、包大小和更新说明。点 立即更新到 <版本号>。

确认框里核对版本号,点 更新。页面提示「更新已开始」后不要关闭浏览器。

看进度#

执行中会按阶段推进:下载、校验、停服、替换、起服、健康检查。停服之后页面连不上后端是预期现象,进度会在服务起来后续上。

看结果#

结束后顶部状态变为「已更新到 <版本号>」或一条失败说明,需要点掉确认。失败时按下面「失败了怎么办」处理,不要立刻再点一次更新。

预期结果

重新打开 系统更新,当前版本 与目标版本一致,状态为已是最新或已更新;登录、采集配置页面能正常打开。

升级或降级到历史版本#

手动更新 / 降级 列出发布源上的版本历史。每行有发布时间、包大小,并用标签区分:

标签含义
最新发布源上的最新版本
当前这台机器正在跑的版本,按钮是灰色的 当前版本
降级版本号低于当前版本

点 更新 或 降级。降级按钮是危险操作样式,确认框语气也不同。没有当前平台安装包的行会标「无当前平台产物」,按钮不可用。列表不对时点 刷新版本列表。

版本历史上方的三种标签;这一行没有本平台安装包时,更新按钮不可用
  1. 1辨认三种标签
  2. 2选择一个版本

这里不是从 U 盘选文件

这个页签仍然从发布源拉包。机器访问不了发布源时,列表会是空的或检查失败,请改用安装器模块包。

用安装器安装离线模块包#

模块包文件名形如 <模块>-<版本>-<系统>-<架构>.iiotmod。可安装的模块名是 backend(灵犀·Studio 服务)、web(页面)、edgeserver(采集引擎)、sidecar(配置生成)、dotnet(采集引擎运行时)。把包拷到设备上之后,用管理员权限执行:

查看版本、安装、回滚
iiot-installer update list
sudo iiot-installer update apply --file backend-1.1.0-linux-x64.iiotmod
sudo iiot-installer update rollback --module backend --version 1.0.0

update list 打印整包版本、各模块当前版本和可回滚的历史。apply 会停掉该模块对应的服务,把旧版本留在数据目录的模块历史里,校验通过后换上新文件并重新启动。rollback 切回已经留在本机的某个历史版本。Windows 上程序名是 iiot-installer.exe,同样需要管理员权限。

安装器会按包内摘要做完整性校验。校验失败时不会替换正在运行的文件。

失败了怎么办#

页面和安装器给出的结果可以直接对照:

结果现场状态下一步
已自动回滚已回到更新前的版本,服务可用看失败原因,排除后再试
下载失败当前版本没有被改动检查这台机器到发布源的网络,然后重新发起
更新已中止安装目录未改,当前版本仍在运行按提示排查后重试
更新中断后端已经能响应可以直接重新发起更新
严重失败需要人工处理按页面给出的备份位置,在设备上恢复服务;不要反复点更新

下载或校验阶段失败时,采集配置和页面都还是旧的。已经进入替换之后失败的,由自动回滚把服务拉回来。

常见问题#

点了更新,页面一直转圈或打不开#

停服到健康检查这段时间,浏览器连不上灵犀·Studio 服务是正常的。等到确认框里写的 2~5 分钟(低配可以再等一会儿)。仍然打不开时,在设备上执行 iiot-installer update list 看服务是否已回到旧版本。

检查更新失败#

发布源暂时不可达,或这台机器出站网络不通。当前版本不受影响。恢复网络后点 重新检查;现场不允许出站时,改用模块包。

更新后画面还是旧的#

页面文件由 web 模块提供。如果只更新了 backend,浏览器可能还缓存着旧页面。强制刷新一次;仍然不对,再安装对应版本的 web 模块包。

下一步#

  • 备份与恢复 升级前的标准备份、加密和恢复确认都在这一页。
  • 日志与诊断包 更新后若服务起不来,用日志定位停在哪一步。
  • 端口与防火墙 检查更新要能访问发布源,对内端口不必对局域网开放。

这篇文档对你有帮助吗?