升级与回滚
在系统设置里查看当前版本,用在线更新或历史版本完成升级与降级;设备访问不了发布源时,用安装器的模块包离线安装,失败时回到升级前的版本。
视频教程 · 灵犀·Studio 从入门到精通 · 第 12 集 3:49
北向集成、权限与运维升级
你将完成
读完本篇你将完成:
- 在页面上确认当前版本、最新版本和运行平台;
- 完成一次在线升级,或在版本历史里升级 / 降级到指定版本;
- 知道失败时系统会自动回滚,以及什么时候要改用安装器模块包。
升级时实际发生什么#
页面里的 系统更新 会停掉并重启 灵犀·Studio 服务,同时替换页面文件。确认框写明:更新期间服务暂时不可用,通常 2~5 分钟,低配设备可能更久;页面会短暂连不上,属于正常现象,不要关闭页面,也不要重启设备。新版本如果启动失败,系统自动回滚到当前版本。
这次页面更新不会停止采集引擎。服务重启的那几分钟里,浏览器里的监控、下发、告警通知和历史入库会暂停;采集引擎与现场设备的连接保持,服务恢复后页面重新接上。
用安装器安装某一个模块时,只重启对应的服务:backend 重启灵犀·Studio 服务,web 重启页面,edgeserver 重启采集引擎,sidecar 重启配置生成服务。dotnet 运行时变更会同时重启采集引擎和配置生成服务。
升级前检查#
看当前版本#
打开 系统管理 → 系统设置 → 系统更新。顶部状态卡给出三列:当前版本、最新版本、运行平台(操作系统 / 架构)。
- 1看当前版本
- 2看运行平台
截图里的版本号来自开发环境
开发机构建可能显示一串提交号(例如带 dirty)。按安装包装好的设备上,这里是发布版本号,运行平台是 windows 或 linux 加架构。看的是这三列,不是某一台机器上的具体字符串。
状态卡下方有两个页签:在线更新、手动更新 / 降级。
先备份,再选时段#
- 按备份与恢复做一份 标准备份,需要连同历史曲线一起带走时再选完整备份;
- 安排在没有人正在改采集配置、没有人依赖画面操作设备的时段;
- 降级一定要先备份。确认框会提示:降级可能丢失新版本引入的数据结构或配置。
页面提示不支持在线自更新时
若新版本卡片上出现「当前运行平台不支持在线自更新」,不要反复点 立即更新。改用下面的安装器模块包。
在线升级#
确认新版本并开始#
在线更新 页签在进入页面时会自动检查发布源。
- 已是最新:显示 已是最新版本,可点 重新检查;
- 有新版本:卡片列出版本号、发布时间、包大小和更新说明。点 立即更新到 <版本号>。
确认框里核对版本号,点 更新。页面提示「更新已开始」后不要关闭浏览器。
看进度#
执行中会按阶段推进:下载、校验、停服、替换、起服、健康检查。停服之后页面连不上后端是预期现象,进度会在服务起来后续上。
看结果#
结束后顶部状态变为「已更新到 <版本号>」或一条失败说明,需要点掉确认。失败时按下面「失败了怎么办」处理,不要立刻再点一次更新。
预期结果
重新打开 系统更新,当前版本 与目标版本一致,状态为已是最新或已更新;登录、采集配置页面能正常打开。
升级或降级到历史版本#
手动更新 / 降级 列出发布源上的版本历史。每行有发布时间、包大小,并用标签区分:
| 标签 | 含义 |
|---|---|
| 最新 | 发布源上的最新版本 |
| 当前 | 这台机器正在跑的版本,按钮是灰色的 当前版本 |
| 降级 | 版本号低于当前版本 |
点 更新 或 降级。降级按钮是危险操作样式,确认框语气也不同。没有当前平台安装包的行会标「无当前平台产物」,按钮不可用。列表不对时点 刷新版本列表。
- 1辨认三种标签
- 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 模块包。
下一步#
这篇文档对你有帮助吗?