问题说明

来源与分类

• 来源渠道：veeam &Commvault使用说明群现场案例。
• 分类结论：Worker初始化阶段的流程等待或关机动作未完成问题。
• 确认依据：2026年6月24日群内确认，创建Worker时初始化脚本包含删除软件包的命令，该命令会等待后重试；出现现场截图所示界面后，可以在ZSphere UI中关闭Worker。现场反馈该方法有效。
• 内部追踪：暂无明确Jira。

问题元数据

• 问题编号：暂无。
• 组件/产品：ZSphere与Veeam Worker。
• 状态：已有现场有效的临时处理方法，唯一根因和永久修复方案尚未确认。
• 优先级/严重程度：一般；会阻断当前Worker创建或初始化流程。
• 受影响版本：原始案例未提供准确版本。
• 首个修复版本：暂无。
• 问题确认日期：2026-06-24。
• 最后更新时间：2026-09-04。

问题描述

创建Veeam Worker时，Worker虚拟机启动后会执行系统准备和软件包处理操作。现场案例中，初始化过程包含删除软件包的命令，该命令没有立即结束，Worker长时间停留在初始化界面，也没有按预期自动关机，导致创建流程看起来处于卡住状态。

群内给出的处理说明为：

veeam在创建worker时，有个指令会去删除软件包，等会重试一下，
然后出现这个界面时候，UI上关机就好了。

现场随后确认该方法有效。由于聊天记录没有提供具体的软件包名称、命令退出码和脚本日志，不能据此认定所有Worker未自动关机都由同一个命令或产品缺陷引起。处理前应先确认控制台仍停留在同类初始化阶段，并保存任务和日志信息。

现象

• 创建Worker后，Worker虚拟机已经启动，但创建任务长时间未完成。
• Worker控制台停留在初始化或系统准备界面。
• 初始化过程中正在执行或等待软件包删除操作。
• 等待一段时间后，脚本可能自动重试相关命令。
• 已出现现场确认的指定界面，但Worker没有自动关机。
• Veeam或ZSphere侧仍显示Worker创建中、初始化中，或者任务未继续推进。

现场截图

影响

• 当前Worker无法按预期完成创建和注册。
• 依赖该Worker的新备份、恢复或数据传输任务无法开始。
• 已存在且状态正常的其他Worker通常不受直接影响。
• 当前没有证据表明该问题会损坏已有备份数据或业务虚拟机数据。
• 如果在软件包处理仍进行时强制关机，可能造成Worker系统不完整，需要重新创建。

适用环境

• 产品：ZSphere与Veeam集成。
• 产品线：ZVF。
• 组件：Veeam Worker初始化脚本和创建流程。
• 版本：原始案例未提供准确版本。
• 触发条件：Worker初始化过程中软件包处理命令等待或重试，完成指定阶段后关机动作未执行。

可能原因

该现象可能由以下一种或多种情况导致：

• Worker 初始化期间的软件包处理命令仍在等待或重试，流程尚未到达关机阶段。
• 初始化命令已经结束，但预期的自动关机动作没有完成。
• 如果控制台出现文件系统、启动或内核错误，则不属于本文已确认的处理分支。

排查步骤

1. 确认所处阶段

1. 在ZSphere任务中心找到本次Worker创建任务，记录开始时间、当前状态和完整错误详情。
2. 打开Worker虚拟机控制台，确认系统仍可响应，并记录当前界面。
3. 判断是否属于以下情况：

• 控制台显示正在执行软件包删除或系统清理操作；
• 相关命令正在等待或重试；
• 脚本已经结束并出现现场确认的初始化完成界面，但虚拟机没有自动关机。

4. 如果控制台显示文件系统错误、启动失败、内核异常或其他明确故障，不要按本文直接关机，应先按实际错误排查。

2. 等待软件包处理命令重试

1. 软件包删除命令仍在运行或正在重试时，先保持Worker虚拟机运行。
2. 不要连续发送中断键、重启虚拟机或重复触发创建任务。
3. 观察控制台是否有新的输出，以及命令是否在等待后自动重试。
4. 同时检查创建任务是否仍有进度更新。
5. 保存等待期间的控制台截图和任务详情，便于判断是否确实没有进展。

群内只确认该命令会等待后重试，没有给出固定等待时长。现场操作时应根据控制台输出和任务更新时间判断，不能把某个统一分钟数作为强制关机条件。

3. 在指定界面出现后从UI手动关机

当软件包处理已结束，并且控制台已经出现与群内现场截图一致的界面，但Worker仍未自动关机时：

1. 再次确认控制台没有正在执行的命令或持续写入的安装输出。
2. 在ZSphere UI中选择该Worker虚拟机。
3. 执行正常的“停止”或“关机”操作。
4. 等待虚拟机状态变为已停止。
5. 返回Veeam或Worker创建页面，观察初始化流程是否继续并完成状态更新。
6. 确认Worker被正确识别后，再执行后续备份或恢复验证。

4. 手动关机后任务仍未完成

如果Worker已经关机，但创建任务没有恢复：

1. 刷新Worker和任务状态，确认是否只是页面状态未更新。
2. 检查Worker是否已经注册，是否生成重复或残留的Worker记录。
3. 查看创建任务和管理节点日志，确认流程是在等待关机状态、等待回调，还是已经失败。
4. 不要立即删除Worker。先保存虚拟机UUID、任务UUID、控制台截图和日志。
5. 确认任务已明确失败且没有后台动作后，再按当前版本部署文档重新创建Worker。
6. 如果重复出现相同卡点，停止反复重试并联系研发分析初始化脚本。

5. 重新创建前检查

确需重新创建Worker时，先检查：

1. Worker所用镜像或模板完整且版本匹配。
2. Worker配置使用可用的静态IP；DHCP响应慢可能造成另一类创建超时问题。
3. 目标主机、计算资源、存储和网络均满足Worker部署条件。
4. 上一次失败任务已经结束，没有仍在运行的软件包安装、删除或初始化任务。
5. 没有名称、IP或UUID冲突的残留Worker记录。

6. 收集信息

问题仍未解决时，收集以下信息后联系研发：

• ZSphere、API Proxy和Veeam的准确版本；
• Worker名称、虚拟机UUID和创建任务UUID；
• 创建任务完整详情和失败时间；
• Worker控制台从开始初始化到卡住阶段的连续截图；
• 软件包删除命令前后的完整输出；
• Worker虚拟机启动、关机和手动操作时间；
• 手动关机后Veeam及ZSphere显示的Worker状态；
• 管理节点日志、Worker初始化日志和Veeam任务日志；
• 是否可以稳定复现，以及每次是否卡在相同命令或界面。

补充信息

注意事项

• 群内确认的是特定现场的有效处理方法，不代表所有Worker初始化卡住都可以直接手动关机。
• 必须等待软件包处理结束并出现现场确认的指定界面后，才能从UI执行正常关机。
• 如果控制台仍在输出安装或删除进度，不要关机。
• 不建议使用宿主机命令强制结束Worker虚拟机进程，以免破坏虚拟机系统状态。
• “没有有效的主机可用”、DHCP超时和Worker初始化后未自动关机属于不同阶段的问题，应根据任务卡点分别排查。
• 在未保存日志和任务详情前，不要反复删除、重建Worker。

修复状态

• 当前状态：已有现场临时处理方法。
• 临时处理：等待软件包处理命令重试；确认进入指定界面且命令结束后，从ZSphere UI正常关闭Worker。
• 永久修复：尚未确认。
• 修复版本：暂无明确版本。
• 关联补丁/修复包：暂无。

关联信息

• 原始讨论时间：2026-06-24。
• 来源群：veeam &Commvault使用说明。
• 现场结果：群内反馈等待重试并在指定界面从UI关机的方法有效。
• 建议配图：Worker初始化停留界面，以及软件包删除命令结束后可执行UI关机的界面截图。