问题说明

来源与分类

• 来源渠道：veeam &Commvault使用说明群现场案例。
• 分类结论：Veeam备份前置组件安装或连通性问题。
• 确认依据：现场执行Kaspersky Server备份时，Veeam提示目标主机上的data-agent安装后未能在16443端口通过健康检查；群内另一个多管理节点案例确认，本地安装方式可能只在当前管理节点完成部署，其他管理节点不会自动接收部署参数，需要使用deploy方式安装。
• 内部追踪：暂无明确Jira。

问题元数据

• 问题编号：暂无。
• 组件/产品：ZSphere、Veeam Data Agent及API Proxy部署组件。
• 状态：已有排查方法和多管理节点场景下的规避方案，具体根因需根据端口监听、服务日志和网络连通性确认。
• 优先级/严重程度：一般；会阻断受影响主机或虚拟机的备份任务。
• 已确认版本：当前群内确认适配的Veeam版本为13.1.1.18。
• 首个修复版本：暂无。
• 问题确认日期：2026-08-13。
• 最后更新时间：2026-09-04。

问题描述

Veeam执行备份任务前，会在相关主机上安装或检查data-agent，并访问该主机的16443端口确认组件是否已经就绪。如果安装完成后服务没有启动、端口没有监听、网络或防火墙阻断连接，或者多管理节点环境中组件实际安装在另一个节点，健康检查会失败，备份任务随之终止。

现场案例中的完整报错为：

2026/8/13 13:55:40 :: Kaspersky Server : Failed to perform backup: host data-agent did not become healthy on 172.27.220.211:16443 after installation

该报错只能说明Veeam无法确认指定IP上的data-agent已经就绪，不能仅凭这一行日志判断是服务启动失败、安装位置错误还是网络不通。应先确认报错IP对应的节点，再分别检查安装结果、端口和访问链路。

现象

• 备份任务在安装或检查data-agent阶段失败。
• 任务日志出现：

  Failed to perform backup: host data-agent did not become healthy on <IP>:16443 after installation

• 在报错IP对应节点执行端口检查时，可能看不到16443处于监听状态。
• 多管理节点环境中，可能只有执行本地安装的管理节点监听16443，另一个管理节点没有监听。
• 服务和端口正常时，也可能因为节点间路由、防火墙或地址选择错误导致Veeam无法访问该端口。

现场截图

影响

• 使用受影响节点执行的备份任务失败。
• 其他已经正常部署data-agent且16443端口可达的节点不一定受影响。
• 当前没有证据表明该问题会破坏已有备份数据或虚拟机磁盘数据。
• 在未确认原因前反复安装或卸载组件，可能覆盖现场日志并增加排查难度。

适用环境

• 产品：ZSphere与Veeam集成。
• 产品线：ZVF。
• 组件：Veeam Data Agent及相关部署组件。
• 已确认版本：Veeam13.1.1.18适配环境；其他版本是否受影响需单独验证。
• 触发条件：安装后指定节点的data-agent未能通过16443端口健康检查，或Veeam无法访问该端口。

可能原因

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

• 报错节点上的 data-agent 或相关服务未完成安装、仍在启动或启动失败，导致 16443 端口未监听。
• 目标节点已经监听端口，但 Veeam 服务器到该节点的路由、防火墙或访问策略阻断连接。
• 多管理节点环境使用了只覆盖本地节点的安装方式，报错 IP 对应的节点没有完成组件部署。

排查步骤

1. 确认报错IP对应的节点

1. 记录报错中的IP地址和失败时间。
2. 在ZSphere中确认该IP属于哪个管理节点或相关服务节点。
3. 确认Veeam任务实际应访问的节点是否与报错IP一致。
4. 如果环境存在多个管理节点，不要只检查当前登录或执行安装命令的节点。

2. 检查16443端口

登录报错IP对应节点并执行：

ss -lntp | grep ':16443'

• 有监听结果：继续检查从Veeam服务器到该端口的连通性。
• 没有监听结果：检查data-agent或相关部署服务是否安装、是否正在启动，以及日志中是否存在启动失败。

如果无法确定服务单元名称，可先检查相关进程和服务：

ps -ef | grep -i data-agent
systemctl list-units --type=service | grep -Ei 'data-agent|veeam|api-proxy'

发现对应服务后，查看服务状态和日志。服务名称及日志路径以当前安装包和部署文档为准，不要直接套用其他版本的服务名。

3. 从Veeam服务器检查连通性

在Veeam服务器上验证报错IP的16443端口：

Test-NetConnection <报错IP> -Port 16443

根据结果处理：

• TcpTestSucceeded为False且目标节点未监听端口：优先检查组件安装和服务启动。
• 目标节点已经监听，但远端测试失败：检查管理网络路由、访问控制和节点防火墙。
• 端口可以连接但任务仍报健康检查失败：检查服务日志、证书或健康检查接口返回，不要只检查TCP端口。

4. 多管理节点环境核对安装方式

群内另一个现场案例中，直接执行以下本地安装命令后，只有一个管理节点监听16443：

./install-api-proxy.sh --install

讨论结论是本地安装没有接收多节点部署所需参数，应改用安装包提供的deploy方式进行部署。

因此，如果报错IP属于未安装组件的另一个管理节点，可按以下方式处理：

1. 保存现有安装输出和日志。
2. 核对安装包部署文档中的多管理节点参数、VIP及节点列表。
3. 使用对应版本安装包提供的deploy方式重新部署，确保所有指定节点都完成安装。
4. 部署完成后，逐个管理节点检查16443端口监听情况。
5. 从Veeam服务器分别验证相关节点或VIP的端口连通性，再重新执行备份。

5. 服务启动后重新验证

1. 确认报错IP上的相关服务处于运行状态。
2. 确认16443已经监听。
3. 从Veeam服务器确认端口可达。
4. 按部署文档提供的健康检查方式验证服务响应。
5. 重新执行备份任务，确认不再出现data-agent健康检查失败。

6. 仍未恢复时收集信息

如果上述检查后问题仍未解决，收集以下信息后联系研发：

• ZSphere、API Proxy及Veeam的准确版本；
• Veeam任务名称、失败时间和完整会话日志；
• 报错中的节点IP以及该IP对应的节点角色；
• 管理节点数量、VIP配置和本次采用的安装方式；
• 每个相关节点的ss -lntp | grep ':16443'结果；
• data-agent、API Proxy及安装脚本日志；
• 从Veeam服务器执行Test-NetConnection的结果；
• 问题发生前是否执行过升级、卸载、重新安装或管理节点切换。

补充信息

注意事项

• 本文中的Kaspersky Server是发生失败的备份对象名称，不代表该问题仅影响Kaspersky产品。
• host data-agent did not become healthy是健康检查结果，不等同于已经确认data-agent进程崩溃。
• 多管理节点本地安装只覆盖一个节点，是群内另一个案例提供的排查方向；只有在报错IP确实未完成部署时，才按该分支处理。
• 如果所有节点均已正确部署并监听16443，不要重复使用deploy安装，应继续排查网络、证书和健康检查响应。
• 不要为了恢复备份直接关闭整机防火墙。确需调整访问策略时，只开放Veeam服务器到目标节点所需端口，并遵循现场安全规范。
• 不要在没有部署文档或研发确认的情况下删除服务文件、卸载组件或修改数据库。

修复状态

• 当前状态：已有诊断步骤和多管理节点部署规避方法。
• 通用修复：暂无证据表明所有此类报错都由同一个产品缺陷导致。
• 多管理节点场景：确认本地安装未覆盖目标节点时，改用对应安装包的deploy方式部署。
• 修复版本：暂无明确版本。
• 关联补丁/修复包：暂无。

关联信息

• 原始报错时间：2026-08-13 13:55:40。
• 原始报错对象：Kaspersky Server。
• 原始报错节点：172.27.220.211:16443。
• 多管理节点安装讨论时间：2026-08-31。
• 来源群：veeam &Commvault使用说明。
• 建议配图：搜索healthy显示的原始报错截图，以及多管理节点中一个节点监听16443、另一个节点未监听的对比截图。