统一数字底盘（Matrix/UDTP）升级包上传完整说明

一、上传节点选择（双机主备集群）

1. 前台 Web 界面上传（推荐，99% 现场使用）

• 操作入口：登录集群业务虚 IP（Matrix 页面 https://虚IP:8443/matrix/ui）→ 部署→融合部署→上传 UDTP 底盘升级包
• 机制：系统内部集群同步机制会自动把升级包同步到所有备节点，升级时集群统一读取，无需人工拷贝到备机。
• 禁止单独登录备节点 Web 上传，会导致集群包文件不一致、升级预检失败。

2. 后台 SSH 手动上传（离线包 / 补丁场景）

1. 优先上传主节点；
2. 上传后主节点会自动同步至备节点；若同步异常，再手动拷贝到备节点同目录；
3. 不建议只传备节点，主节点无包会直接报错升级找不到文件。

总结：不用随便传一个，必须传当前集群 Leader 主管理节点。

二、两种上传方式对应的存放目录

方式 1：Web 界面上传（融合部署页面上传 UDTP 完整底盘包）

方式 2：SSH 工具（WinSCP/MobaXterm）后台手动上传离线升级包 / 补丁

标准目录（Matrix 统一数字底盘集群）

1. 完整 UDTP 底盘大升级包
   /opt/matrix/upgrade/
2. 热补丁 / 小版本修复包
   /opt/matrix/patch/
3. 补充：Matrix 自身底层组件升级包同样上传至 /opt/matrix/upgrade/

操作规范

1. 用 root 账号 SSH 登录主节点；
2. 上传压缩包至对应目录；
3. 修改权限：chmod 755 升级包文件名；
4. 登录 Matrix 页面刷新融合部署列表，即可识别离线包。

三、关键注意事项

1. 双机集群不要分别上传主、备节点，重复上传会造成文件冲突、升级校验不通过；
2. 升级前先确认集群 Leader 主节点：Matrix 页面【部署→集群】查看节点角色；
3. 离线包上传后若页面看不到文件，执行 matrixctl sync-file 手动触发集群文件同步；
4. 升级顺序规范：先升级 Matrix 底层包，再升级统一数字底盘 UDTP 包，两个包都上传至主节点 /opt/matrix/upgrade/。