镜像预下发显示已同步，为什么还不能认定终端已更新

在 vDisk 环境里做镜像版本切换时，容易把“预下发完成”直接当成“终端已经用上新版本”。这两件事的对象不同：预下发的目标是把主服务器上的镜像同步到选定的 IO 服务器，终端是否下载、合并并进入新版本，需要另外确认。

前提

· 目标 IO 服务器已在服务器管理中注册，并且处于在线状态。

· 控制台可进入镜像预下发入口，菜单路径为“其他→镜像预下发”；不同版本或语言下菜单名可能不同，以实际界面为准。

· 明确要下发哪个镜像、落到哪台 IO 服务器、使用哪个存储卷以及落地镜像名。

发起预下发

· 在控制台进入镜像预下发页面。

· 选择主服务器上的源镜像。

· 选择目标 IO 服务器，并指定目标存储卷与落地镜像名。

· 提交后由系统按服务器之间同步磁盘的机制传输，页面按镜像和 IO 服务器展示状态。

预下发的用途是提前把镜像放到就近的 IO 服务器，适合出口或主干带宽有限的环境。终端侧不需要为预下发修改配置。判断时仍需把“服务器间同步完成”和“终端上的版本已生效”分开。

读状态：页面显示什么

预下发页面按“镜像 + IO 服务器”的组合显示状态，并周期刷新，常见状态包括：

· 未下发：界面将该镜像在目标 IO 服务器上的状态标为未下发；先确认是否已选定目标并发起操作。

· 同步中：正在传输，页面会显示版本进度。

· 已同步：镜像已经到达该 IO 服务器。

· 服务器离线：目标 IO 服务器当前不可达，同步无法推进。

看到“已同步”，只能说明镜像到 IO 服务器的同步这一环完成，不能据此推断终端已经下载、合并或运行了新版本。终端是否切换版本，需要以终端侧的实际状态为准；这部分没有对应的预下发页面字段可读。

速度与计划参数

预下发复用服务器之间同步磁盘的机制，因此高级速度和计划参数不在预下发页面调整，而是在磁盘树的同步盘上设置。如果不再需要该同步盘，同样在磁盘树中删除。

限制与排查方向

· 显示“服务器离线”时，先核对目标 IO 服务器的在线状态，再观察同步进度。

· 状态为“已同步”不等于任务整体成功，终端侧的下载与切换结果需另行确认。

· 若长时间停在同步中，可检查目标存储卷容量、同步盘参数与网络状况，具体原因需要现场排查，不能仅凭页面状态下结论。

· 无需修改终端配置，不等于无需核对终端实际运行的版本。

把预下发当成“把镜像搬到就近 IO 服务器”的一步，把“已同步”读成“服务器这一跳完成”，终端版本是否生效再单独验证，就能避免把中间状态当成最终结果。