镜像下载失败

H3C Workspace镜像下载失败，提示“任务已存在”，这通常是因为上次下载中断后，相关的临时任务记录或残留文件未被系统及时清理，导致平台认为任务仍在运行，从而阻止了新的下载尝试。

你可以按照下面的步骤逐步尝试解决，建议在一个步骤完成后，就先去平台看看问题是否已经解决。

 第一步：清除下载任务缓存

如果系统允许，这是最直接的修复方法。

1. 清除浏览器缓存：退出管理平台，清理浏览器近一小时的缓存、COOKIE和历史记录。

2. 登录管理平台：访问H3C Workspace管理平台首页，进入桌面镜像或镜像管理等相关模块。

3. 检查任务状态：在任务管理界面，找到并检查之前的下载任务。如果系统支持，请手动点击 “取消”、“删除” 或 “重置” 该任务，然后重新下载。

 第二步：清理平台临时文件

如果无法在界面上取消任务，或清理后仍无效，可能是平台服务器上留有临时文件，需要手动清理。

1. 定位临时目录：登录到H3C Workspace平台的底层宿主机（通常是CVK节点），并进入目录：/vms/tmp/tmpDomain/。另外也可以检查 /vms/downloadFileTempDirectory/ 目录。

2. 识别残留文件：在该目录下，查找与当前失败的下载任务相关的临时文件。

3. 执行清理：在确认文件无用后，安全地删除这些临时文件。

4. 跨节点检查：如果你的平台由多个宿主机（CVM和CVK）组成，可能需要登录到CVM节点，检查并删除同样的临时文件，以保持集群状态一致。

 第三步：检查镜像是否被占用

有时“下载任务已存在”的提示，是因为这个镜像正在被其他进程使用。

• 检查镜像状态：登录管理平台，在桌面镜像页面找到目标镜像。

• 查看关联任务：确认该镜像是否关联了其他正在发布、克隆或删除的任务。如果有，请等待这些任务完成后再尝试下载。

 第四步：重启相关服务

如果以上步骤都无法解决问题，可以尝试重启平台的后台服务。

• 重启Tomcat服务：在CVK或CVM后台，使用命令 service tomcat8 restart（根据实际版本，命令可能为 tomcat、tomcat9 等）。执行此操作前，务必确认当前无重要业务运行。

• 等待并重试：服务重启后，等待几分钟让系统完全就绪，再登录平台重试下载任务。

1. 查看当前下载任务：`display system image download`
2. 清理残留任务：`reset system image download` (执行前请确认无其他必要下载任务) 这些命令在什么地方执行？

一、Web 界面：取消 / 删除残留任务（优先）

1. 登录 UIS 管理平台
2. 进入：系统 → 系统镜像 → 下载任务 / 任务管理
   • 找到你那个 中断的下载任务（状态：下载中 / 失败 / 异常）
   • 点 取消 / 删除 / 终止
3. 若提示 任务进行中无法删除：
   • 刷新页面、换浏览器、清缓存后再试
   • 仍不行 → 直接用 命令行强制清理

二、CLI 命令行：强制清理下载任务（最有效）

1. 查看当前残留下载任务

2. 强制重置 / 清除所有下载任务

• 提示确认：输入 Y 确认
• 作用：强制结束所有镜像下载任务、清除锁、重置状态

3. （可选）清理镜像服务缓存

三、底层清理：删除残留临时文件（仍不行时）

四、清理后重新下载

1. 回到 Web：系统 → 系统镜像 → 下载
2. 重新输入 URL / 选择文件 → 下载
3. 正常出现进度条 → 成功

五、为什么会这样（原理）

• 下载中断 → 任务状态卡在 “下载中”
• 数据库 / 内存里 任务锁未释放
• 系统判断：同名任务已存在 → 拒绝新下载
• reset system image download 就是 强