版本升级配置指南
概述
矩尺平台支持对管理节点和转发引擎进行独立的版本升级与回退。由于 v4.1.2 版本新增了版本回退功能，升级和回退的顺序至关重要——错误的顺序可能导致管理节点与转发引擎版本不匹配，甚至造成页面功能不可用。
升级操作在【平台系统 → 升级】菜单中完成，具体 UI 操作步骤参见用户手册 - 升级。
升级前检查与准备
磁盘空间检查
升级包上传和解压需要充足的磁盘空间，建议在升级前确认：
- 管理节点：
/var/log或自定义数据根目录下至少保留 5GB 可用空间 - 转发引擎：对应存放目录下至少保留 2GB 可用空间
- 若磁盘空间不足，升级包传输或解压可能失败，设备状态将停留在"升级包传输中"或"升级失败"
可在【平台系统 → 基础设施 → 管理节点】中查看各设备的磁盘使用情况。
升级包上传
- 在升级列表中点击上方"升级包上传"按钮
- 选择格式为
.tar.gz的升级包附件上传 - 上传过程中设备状态显示为"升级包传输中"并附带进度条
- 上传完成后状态变为"升级包就绪"
升级包请联系矩尺相关人员获取，请勿修改安装包文件名称，否则上传后无法通过校验。
升级目录设置
在升级前可根据实际情况设置升级包存放目录：
| 场景 | 设置方式 |
|---|---|
| 所有设备统一目录 | 点击搜索栏下方"默认存放目录"按钮，设置全局默认路径 |
| 单设备指定目录 | 在升级列表中找到目标设备，点击操作栏中的"升级包存放目录"按钮，为该设备单独指定路径 |
- 管理设备仅能选择下拉框已有的目录项
- 其他设备（转发引擎）可自主设置存放目录
升级执行顺序
升级顺序说明
由于 v4.1.2 才支持版本回退，升级时必须严格按照以下顺序执行，否则后续无法完成回退操作。
第一步：升级管理节点
优先升级 → 主管理节点（升级完成）
↓
备管理节点（升级完成）- 单管理节点：直接升级即可
- 双管理节点集群：务必先升级主管理节点，待其升级完成后，再升级备管理节点
- 升级过程中设备状态依次经历：升级中 → 升级完成（当前版本更新）
第二步：批量升级转发引擎
管理节点升级完成后，可勾选一个或多个转发引擎进行批量升级：
- 支持多选，所选设备将逐个升级
- 升级成功的设备显示"升级完成"，当前版本自动更新
- 升级失败的设备旁会显示"升级"按钮，可点击重试
最佳实践
生产环境推荐升级路线：
① 在测试环境验证升级包
↓
② 备份管理节点配置（【平台系统 → 配置管理 → 备份恢复】）
↓
③ 非业务低峰期操作
↓
④ 先升主管理节点 → 再升备管理节点 → 最后批量升转发引擎
↓
⑤ 观察一段时间，确认业务正常版本回退
v4.1.2 新增版本回退功能，支持将已升级的设备回滚到升级前的版本。回退时可选版本回滚（仅回退软件版本）或数据回滚（版本和数据一同回退）。
回退顺序（关键）
回退顺序必须严格遵守
回退操作的顺序与升级完全相反，必须先回退转发引擎，再回退管理节点，且管理节点要先回退备节点、再回退主节点。
回退第一步 → 转发引擎（全部回退完成）
↓
回退第二步 → 备管理节点（回退完成）
↓
回退第三步 → 主管理节点（回退完成）为什么必须按此顺序？
- 版本兼容性：管理节点与转发引擎的版本必须匹配。若先回退管理节点，管理节点版本低于转发引擎，可能导致管理接口不兼容，转发引擎失管
- 功能可用性：回退按钮存在管理节点页面上。若先回退管理节点，管理节点版本回退后不再包含回退功能，页面上的回退按钮将消失，剩余设备将无法继续回退
- 数据一致性：先回退数据面（转发引擎）再回退管理面，确保在管理节点回退过程中不再有新的配置变更下发
回退操作
- 在升级列表中勾选需要回退的设备（支持多选）
- 点击列表上方"版本回退"按钮
- 在弹出的对话框中选择回退方式：
- 版本回滚：仅将软件版本回退到升级前
- 数据回滚：将软件版本和配置数据一同回退到升级前
- 确认后设备将执行回退操作
注：只有升级完成状态的设备才可以执行回退，且只能回退到升级前的版本。
回退失败处理
- 若某台转发引擎回退失败，不影响其他设备的回退操作
- 回退失败的设备可单独重试回退
- 如多次回退失败，请联系矩尺技术支持
升级注意事项
| 检查项 | 说明 |
|---|---|
| 版本兼容 | 跨大版本升级可能不支持直接跳级，请逐版本升级或咨询矩尺技术支持 |
| 配置备份 | 升级前建议通过【平台系统 → 配置管理 → 备份恢复】备份当前配置 |
| 业务影响 | 转发引擎重启升级期间对应业务流量会中断，建议在业务低峰期操作 |
| 集群顺序 | 双管理节点集群严格遵循先主后备的升级顺序和先后备再主的回退顺序 |
| 磁盘空间 | 确保各设备有充足的磁盘空间存放升级包 |
| 升级包校验 | 请勿修改升级包文件名，否则上传后无法通过完整性校验 |