问题说明

来源与分类

• 来源渠道：客户支持现场案例。
• 分类结论：Worker创建阶段的主机调度或部署前置条件问题。
• 确认依据：2026年6月11日现场反馈创建Worker失败，并提示“没有有效的主机使用”；2026年8月11日群内进一步建议，创建Worker时应优先使用静态IP，DHCP可能因地址获取超时导致Worker创建失败。
• 内部追踪：暂无明确Jira。

问题元数据

• 问题编号：暂无。
• 组件/产品：ZSphere与Veeam Worker。
• 状态：已有通用检查方法，原始案例的唯一根因和最终处理结果尚未在群聊中明确记录。
• 优先级/严重程度：一般；会阻断Worker创建以及依赖该Worker的备份或恢复任务。
• 受影响版本：原始案例未提供准确版本。
• 首个修复版本：暂无。
• 问题确认日期：2026-06-11。
• 最后更新时间：2026-09-04。

问题描述

在Veeam接入ZSphere后创建Worker时，平台需要从可用范围内选择满足条件的主机，并为Worker准备计算、存储和网络资源。当所有候选主机均不满足调度条件，或者Worker所需网络、地址和存储配置不可用时，创建任务可能失败并提示没有有效的主机可用。

现场记录中的原始描述为：

创建Worker失败有什么原因呢？报错没有有效的主机使用。

该提示表示当前没有主机通过Worker创建前的可用性筛选，但提示本身没有说明具体是哪一项条件不满足。需要结合ZSphere任务详情、主机状态、资源容量、存储状态和Worker网络配置进一步判断。

现象

• 创建Worker时任务直接失败。
• 页面或任务详情提示类似以下内容：

  没有有效的主机可用

或：

  没有有效的主机使用

• Worker虚拟机尚未成功创建，或者创建后未能完成初始化。
• 选择DHCP配置时，Worker可能因获取地址超时而在后续创建阶段失败。
• 同一环境中的普通虚拟机可能仍能运行，但这不能说明所有主机均满足Worker的部署条件。

现场截图

影响

• 无法创建新的Veeam Worker。
• 依赖该Worker执行的备份、恢复或数据传输任务无法继续。
• 已有且状态正常的Worker通常不受本次新建失败直接影响。
• 当前没有证据表明该问题会损坏已有备份数据或业务虚拟机数据。

适用环境

• 产品：ZSphere与Veeam集成。
• 产品线：ZVF。
• 组件：Veeam Worker创建和主机调度。
• 版本：原始案例未提供准确版本。
• 触发条件：没有主机同时满足Worker所需的可用状态、计算资源、存储可达性和网络条件，或者后续网络初始化失败。

可能原因

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

• 候选主机处于维护、失联、禁用或不可调度状态，或者部署约束排除了全部主机。
• 候选主机的计算资源或可访问存储不满足 Worker 部署条件。
• Worker 网络、地址池或 VLAN 配置不可用；使用 DHCP 时还可能因地址获取超时在后续阶段失败。

排查步骤

1. 查看创建任务的详细错误

1. 在ZSphere任务中心找到对应的Worker创建任务。
2. 展开任务详情，记录完整错误码、错误信息、候选主机筛选结果和失败时间。
3. 确认报错发生在以下哪个阶段：

• 选择或调度主机之前；
• Worker虚拟机创建过程中；
• Worker系统启动或网络初始化过程中；
• Worker软件包安装或初始化过程中。

4. 如果任务详情已经给出资源不足、网络不可用或存储不可用等具体原因，优先按具体错误处理，不要只依据“没有有效的主机”这一层提示。

2. 检查候选主机状态

检查计划部署Worker的集群和主机：

1. 主机应处于已连接、启用且可调度状态。
2. 主机不应处于维护模式、失联、禁用或异常状态。
3. 集群中至少应有一台主机满足Worker部署要求。
4. 如果设置了主机范围、集群范围或其他部署约束，确认这些限制没有排除全部主机。
5. 主机状态刚恢复时，等待资源和容量信息刷新后再重试创建。

3. 检查计算资源

1. 检查候选主机的可用CPU和内存是否满足Worker规格。
2. 检查集群是否启用了资源预留、超分限制或其他调度限制。
3. 确认没有因资源标签、亲和性规则或主机策略导致所有主机被过滤。
4. 必要时临时选择更小且受支持的Worker规格进行验证；不要使用低于产品要求的配置长期运行。

4. 检查存储可用性

1. 确认用于Worker系统盘的主存储处于已连接、启用状态。
2. 确认主存储已挂载到候选主机所在集群，并且剩余容量充足。
3. 检查镜像或模板所在备份存储是否可用，候选主机是否能够访问对应镜像链路。
4. 如果只有部分主机可以访问目标存储，确认这些主机同时满足计算和网络条件。
5. 存储状态异常时先恢复存储，不要通过强制选择主机绕过调度检查。

5. 检查Worker网络

1. 确认Worker使用的网络已正确挂载到候选主机所在集群。
2. 确认二层网络、三层网络和IP地址池状态正常。
3. 检查地址池中是否存在足够的可用IP，网关、子网掩码和DNS配置是否正确。
4. 确认Worker网络能够访问ZSphere管理地址、Veeam服务器以及备份流程所需的其他服务。
5. 检查网络对应的物理网卡、VLAN和交换机配置在候选主机上是否可用。

6. 优先使用静态IP创建Worker

群内经验建议创建Worker时优先配置静态IP。DHCP服务器响应慢、地址池耗尽或网络中无法收到DHCP应答时，Worker可能因获取地址超时而创建失败。

处理步骤：

1. 从Worker网络中选择一个未被占用的静态IP。
2. 填写正确的子网掩码、网关和DNS。
3. 创建前检查该IP没有被其他设备使用。
4. 使用静态IP重新创建Worker。
5. Worker启动后验证其能够访问ZSphere管理地址和Veeam服务器。

7. 恢复后验证

1. 重新创建Worker并确认平台能够选出目标主机。
2. 确认Worker虚拟机创建并正常启动。
3. 确认Worker获得预期IP地址，且管理网络通信正常。
4. 等待Worker初始化完成并在Veeam侧显示可用。
5. 执行一次小范围备份或恢复验证，确认Worker可以正常承载任务。

8. 仍未恢复时收集信息

如果完成上述检查后仍提示没有有效的主机，收集以下信息后联系研发：

• ZSphere、API Proxy和Veeam的准确版本；
• 创建Worker的完整操作步骤和配置；
• 任务中心完整错误详情；
• Worker规格、目标集群和允许的主机范围；
• 所有候选主机的连接、启用和维护状态；
• 候选主机的可用CPU和内存；
• 主存储、备份存储及镜像状态；
• Worker所用二层网络、三层网络、IP地址池和VLAN信息；
• 使用静态IP或DHCP，以及对应的地址获取结果；
• 创建失败时间点附近的管理节点日志和Veeam任务日志。

补充信息

注意事项

• “没有有效的主机”是调度结果，不等同于主机已经关机或物理故障。
• 主机在线也不代表一定满足Worker的计算、存储和网络条件。
• 不要为了出现候选主机而直接修改数据库、绕过调度检查或强制指定异常主机。
• 群内确认静态IP可以降低DHCP超时导致的创建失败，但不能解决所有“没有有效的主机”问题。
• 创建Worker过程中执行删除软件包并停留在初始化界面的案例属于另一类问题，其处理方法是等待命令重试并在出现指定界面后从UI关机，不应与本文的主机筛选问题混为同一根因。
• 在未保存任务详情和日志前，不建议反复删除、重建Worker，以免覆盖现场信息。

修复状态

• 当前状态：已有排查和规避方法。
• 通用修复：暂无证据表明该提示由单一产品缺陷导致。
• 网络规避：创建Worker时优先使用静态IP，避免DHCP响应异常或超时。
• 修复版本：暂无明确版本。
• 关联补丁/修复包：暂无。

关联信息

• 原始问题时间：2026-06-11。
• 静态IP建议时间：2026-08-11。
• 来源群：veeam &Commvault使用说明。
• 建议配图：创建Worker提示“没有有效的主机使用”的报错截图，以及静态IP配置界面截图。