SupDRC VMware 故障排查与常见问题
适用产品 V1.2.0 文档版本 V0.3 2026-09-28
苏州捷云盛科技有限公司（Jumborca）
适用读者：一线支持 实施与运维人员。本文说明 V1.2.0 的操作流程、前置条件及使用限制。
1 排查方法与信息保留
先记录现象、时间、对象和任务失败阶段，再检查对应资源。避免同时修改凭证、网络、存储和策略多个变量，否则难以判断哪项变化解决了问题。
在历史任务中读取概览和明细任务，结合 ESXi 和存储端的实际状态定位。任务成功、文件存在、VM 启动分别说明不同阶段完成，不能相互替代。
| 信息 | 记录要求 |
|---|---|
| 环境 | 产品构建、ESXi 版本、客户机版本与内核、Tools 状态 |
| 任务 | 名称、类型、开始结束时间、结果与原始错误提示 |
| 数据路径 | 获取器、源资源、目标存储及恢复目标 |
| 变更 | 最近的凭证、补丁、网络、磁盘或策略调整 |
| 证据 | 任务详情、相应组件日志与脱敏截图 |
| 组件 | 日志路径 | 轮转与容量 |
|---|---|---|
| 数据获取器 supmirror | {部署路径}/supmirror.log | 大于 100 MB 后重命名为 supmirror.log.bak，无按天保留周期 |
| 存储管理 repository | {部署路径}/repository.log | 大于 100 MB 后重命名为 repository.log.bak，无按天保留周期 |
| SupMirror 服务端 | /deploy/app/supmirror-backupserver/logs/ 下的 .log 文件 | 包含 error、warning、info，具体保留规则未提供 |
| SupMirror 服务端实时日志 | /deploy/app/supmirror-backupserver/runtime.log | 超过 1 GB 直接重置 |
发生异常后及时复制相关时段日志，避免轮转或重置导致证据丢失。自动诊断包入口、独立系统日志菜单与审计导出细节未确认。共享前移除密码、私钥及不必要的内部资源信息。
2 从失败阶段开始检查
| 现象 | 优先检查 | 恢复正常的判断 |
|---|---|---|
| VM 在选择器中不可见 | ESXi 凭证、纳管状态、获取器保护关系 | 在正确的 VMware 数据源中可选 |
| 获取器不可用 | 服务器、组件安装、网络和凭证 | 组件可用且能访问源与目标 |
| 快照创建失败 | ESXi 任务、资源空间、VM 状态 | 新任务可创建快照并完成清理 |
| 读取虚拟磁盘失败 | VDDK 路径、连接权限、磁盘配置 | 目标保护范围可读 |
| 目标存储写入失败 | 路径、权限、可用容量、存储连接 | 写入完成且恢复点可读取 |
| 恢复写入失败 | 恢复点、目标 ESXi、资源和磁盘状态 | 指定目标写入成功并可验证 |
表中为检查方向，不代表每个现象只有一种原因。未确认根因前，不通过删除资源、清理底层数据或反复覆盖来试错。
3 安装 登录与许可
3.1 安装下载失败或容器未就绪
记录失败的安装阶段和包名，检查下载源连通性、磁盘空间及安装权限。区分下载失败、镜像加载失败、数据库初始化失败与服务启动失败。安装脚本成功提示不能替代服务和任务验收。
正式脚本和安装包由 Jumborca 产品部门内部维护，实施工程师现场配置，一般不向客户提供。下载失败联系实施工程师核对来源、版本及校验值。当前 SupMirror 服务端不支持升级，不以重新初始化或覆盖新装处理已有业务数据的系统。
3.2 无法登录控制台
先检查 Nginx 提供的 HTTP 80 或 HTTPS 443 管理入口。后端默认 8080，脚本部署容器使用 8090，通过 Nginx 代理；不要将端口混用。HTTPS 证书由部署侧配置。
使用交付人员通过安全方式提供的初始账号和密码登录，不在产品文档中固定初始凭证。首次登录建议立即修改初始密码；当前可确认初始化密码提示，是否强制修改以正式产品配置为准。
连续密码错误 3 次后锁定 15 分钟，JWT 登录令牌有效期为 480 分钟（8 小时）。系统支持用户修改密码和管理员重置密码。登录异常时先核对地址、当前验证码、锁定提示和登录日志，再由管理员处理。
3.3 许可证导入失败
检查 data 文件与配套 pem 文件是否匹配目标设备与授权。当前页面对 pem 提示不超过 5 MB，不能用任意证书文件替代私钥文件。核对文件来源与有效期，并记录原始提示。
当前许可按工作负载功能模块区分，不同类型工作负载加载对应许可证，没有主机、CPU、VM 或容量数量限制；试用与正式许可当前无功能差异。许可到期后，所有备份任务自动设为禁用，调用业务接口会提示授权过期。
导入时须使用配套 data 文件与 pem 私钥文件，pem 最大为 5 MB，超过 5 MB 不允许上传。许可证版本字段与产品 V1.2.0 版本字段不同。设备变更、许可迁移及续期流程由 Jumborca 交付支持确认；续期后应检查授权与任务启用状态，不假定禁用任务会自动恢复。
4 资源与获取器
4.1 ESXi 已添加但 VM 不可见
核对访问对象确为支持范围内的独立 ESXi、凭证适用该主机且权限足够，再确认获取器到 ESXi 的连接及保护关系。界面通用容器或 vSphere 名称不能作为 vCenter 可用依据。
独立 ESXi 地址只填写 FQDN/DNS 名称或 IPv4/IPv6 地址，不添加 http://、https:// 或 /sdk 路径。源端和恢复目标端均使用 root 凭证。
在“基础备份设施 → 数据获取器”找到对应获取器，点击“编辑”建立或修改保护关系。保存后，在被保护资源及备份策略的数据源中验证目标 VM 可见。
后台资源刷新默认每 30 分钟执行一次，可按场景调整。主机替换时编辑原有资源记录后保存，无需先删除旧记录。VM 迁移后，在原备份策略“数据源”中移除失效备份源，重新添加迁移后的备份源，保存并重新执行策略。
独立 ESXi 源端和目标端均要求 root 账号。数据获取器推送安装支持 sudo，不要求直接以 root 登录，但 Linux 组件最终需要 root 等效权限；Windows 组件要求本地管理员权限。客户机账号仅在 Guest Processing 和原位置恢复时需要，不能把客户机凭证作为整机无代理备份的统一前提。
编辑已有凭证记录通常自动作用于引用该记录的对象；新建凭证记录后必须重新绑定相关对象。变更后检查资源、保护关系及实际任务访问，不在文档或日志附件中记录明文密码。
4.2 显示未检测到安装包
检查获取器所属服务器是否正确，SSH 访问与安装权限是否符合交付要求。按页面“点击安装”流程推送组件，记录安装结果。不得因列表显示不可用就直接删除被任务引用的获取器。
4.3 任务慢或获取器负载高
同时观察源 ESXi、获取器、网络和存储，比较任务数据量、并发与耗时，定位瓶颈后再调整参数。
自动选择获取器采用随机选择，并受配置的并发约束。备份前会检测获取器健康状态，排除异常获取器并换用其他健康获取器继续；若没有符合保护关系和连接要求的健康获取器，应检查任务结果，不能保证任务仍能完成。系统有定时检查应用启动状态的任务，发现应用未启动时会自动启动。
带宽限制为 0 表示不限网络带宽。界面的“最大并发磁盘数”在 VMware 中是否生效尚未确认，不能把截图中的 8 当作 VMware 的已验证上限。当前无统一推荐调优范围、吞吐指标或最大保护规模，调整前后应记录实际负载与任务结果。
5 备份异常
5.1 快照失败或清理异常
在 SupDRC 任务详情及 ESXi 任务中核对快照创建、读取和清理结果。数据写入完成后仍可能存在快照清理问题，应由管理员继续跟踪。
不要删除仍被备份读取或其他任务使用的快照，也不要直接删除数据存储中的快照文件。手工合并或清理应按 VMware 和厂商支持流程，在确认任务状态后执行。
5.2 增量失败或备份大小变化异常
SupDRC 执行 VMware VM 备份不依赖虚拟机 CBT 功能。排查增量时应检查已有恢复点、备份链、源磁盘和读写任务状态，不把启用或重置 VMware CBT 作为该产品的必需步骤。
合成全备在存储管理 repository 组件中运行，按顺序将备份链中的备份点写入新的合成备份点。合成成功后删除所有参与合并的备份点，并清理已失效的备份点；失败时删除本次新生成的合成备份点并结束合并。合成期间需要为新备份点预留空间，具体空间量按实际数据评估。
恢复点读取从指定的最后一个还原点标志向前查找，直到全量点，以取得所需备份链。SupMirror 自动保留会维护链完整性；手工在文件系统中删除 .base 全量文件或 .inc 增量文件会破坏依赖链，必须通过 SupDRC 前端控制台删除备份。
全量与增量的数据量受实际变化影响，不能仅凭大小判断任务类型或恢复点有效性。
5.3 存储不足或写入失败
核对存储库实际路径、权限、网络和可用空间，并查看报表中的增长趋势。检查保留周期、副本占用及任务是否在同一时间集中运行。
先安排扩容或经确认的保留调整，再按产品支持方式清理。不要直接删除备份目录以腾出空间；该行为可能破坏恢复链与索引。
6 恢复异常
6.1 异机恢复找不到目标
目标独立 ESXi 必须提前添加并与获取器建立保护关系。检查目标资源可见性、计算和存储资源以及访问凭证。支持“跨 ESXi”不表示可以临时填写任意未纳管主机直接恢复。
6.2 整机任务完成但业务不可用
先核对所选恢复点，再检查 VM 电源、控制台启动信息、磁盘和网卡连接。系统启动后核对 IP、路由、名称解析、关键数据与应用服务。异机 VM 与源 VM 标识冲突时，按预定隔离和业务切换方案处理。
网络 ping 只能验证特定端点的连通性，不能证明数据库、应用事务或文件权限正确。RTO 应以业务恢复验证为终点记录。
6.3 新虚拟磁盘已挂载但客户机看不到
先在 VMware 层确认磁盘已挂载到正确 VM，再在客户机检查设备扫描、联机、盘符及挂载状态。恢复磁盘不是空盘，不应先格式化再查看数据。签名、UUID 或 LVM 冲突需依据目标系统处理，支持范围待确认（Q12）。
6.4 原卷覆盖失败或数据仍被占用
确认访问该卷的应用已停止且目标卷已卸载。产品不会自动冻结文件系统或完成卸载，也不强制关闭目标 VM。不能因界面可提交就认为仍在使用的卷可安全覆盖。
6.5 文件级恢复失败
先检查管理服务器或 BackupServer 的下载临时空间、guestfs 挂载和备份磁盘完整性。下载分支无需先验证远程推送；远程分支再检查 VMware Tools、客户机凭证、目标路径和空间。
下载方式会改变权限等信息；远程不覆盖和远程覆盖保持权限等信息。远程覆盖会替换原文件，不能与不覆盖方式混用；同名文件提示、ACL 及特殊文件细节仍须验证。
7 通知与计划
未收到邮件时先在历史任务确认任务是否执行，再检查 SMTP 地址、端口、凭证、加密设置、通知条件和收件人。测试邮件会实际发送消息，应在组织允许的范围内执行。检查收件箱和垃圾邮件，不能将测试发送成功直接等同于所有任务通知都正确。
任务调度以部署服务器时区为准，任务超时时间为 7 天。人工执行与定时计划冲突时只执行其中一个任务，另一个报错；当前已确认口径为按定时计划执行不会产生该类冲突，不将其扩大为所有不同任务均无资源竞争。
产品不支持断点续传，仅支持数据获取器向存储库传输时的块数据重试，不包含其他方向的重试保证。错过执行点后的补跑、取消细节与节假日规则尚未明确，不能假定自动补跑或从中断点续作。
另检查许可证是否到期：到期会自动禁用备份任务，业务接口提示授权过期。
8 常见问题
无代理是否意味着无需部署组件
客户机 VM 无需安装 SupDRC 备份代理，但基础设施侧必须部署数据获取器，并配置管理服务和备份存储。Guest Processing 和原位置恢复依赖 VMware Tools 和客户机凭证，下载文件分支不要求远程推送。
能否从整机备份恢复单个卷或文件
可以。需符合对应客户机系统、Tools、凭证和恢复方式的条件，并验证目标路径与数据。
是否所有存储都需要网关
不是。网关用于部分外部专用存储硬件，普通本地、NFS、SMB/CIFS 和 S3 存储不统一要求经过网关。
副本任务成功是否意味着已经验证容灾
副本成功说明复制任务完成，还应从目标副本执行恢复并验证业务结果。实际恢复点和恢复时间以演练记录为准。
为什么仍保留兼容性待确认项
CentOS 7.9 客户机已确认可支持；Linux 内核高于 3.10 仅限制数据获取器。版本级支持仍不等于全部补丁、特殊磁盘、系统卷和恢复组合均经过验证；未提供完整矩阵的项目继续按实际组合验证。
9 转交技术支持
提交脱敏的问题摘要、可复现步骤、预期与实际结果、环境版本、任务时间及原始错误。说明已经检查过的项目，保留内部完整证据供授权支持人员使用。不要在工单或公开文档中附带明文密码与私钥。
10 异机恢复创建或写入失败
创建目标 VM 失败时不会写入数据，检查创建错误、目标资源与名称配置。异机恢复写入失败会删除本次创建的目标 VM，应保留任务和组件日志，不把目标消失误判为恢复成功。原机恢复针对唯一原 VM，不涉及新建冲突；原机写入失败后的回退不能套用异机清理规则。
11 服务端故障重建
当前 SupMirror 服务端不支持版本升级，不应把新装脚本用于覆盖升级现有系统。以下为服务器故障且原数据完整时的重建流程，不是跨版本升级或数据丢失恢复方案，应由实施人员在维护窗口执行。
- 导出并妥善保存源机器完整的 /deploy 目录，先确认副本可读取且没有遗漏。原数据或目录不完整时停止套用本流程并联系支持。
- 使用实施脚本安装新服务器，IP 与源机器保持一致。启用相同 IP 前应隔离旧服务器，避免地址冲突。
- 停止新服务器 Docker 服务。
- 核对操作对象确为新服务器并确认源目录副本完整后，删除新服务器安装生成的 /deploy 目录。
- 将源机器的 /deploy 目录导入新服务器，重启 Docker 服务。
- 验证登录、许可、资源与凭证、保护关系、策略、恢复点和实际备份恢复。外部存储数据须保持可访问，不能把仅复制 /deploy 视为已复制全部备份数据。
导出一致性、数据库停写安排、变更 IP、数据丢失、存储迁移和索引重建的完整方案仍需实施支持确认。保留旧服务器和源目录副本直至验收完成。
12 支持渠道
苏州捷云盛科技有限公司（Jumborca）提供 7×24 小时服务。
官网：https://www.jumborca.com 售后渠道：help.jumborca.com
邮箱：service@jumborca.com 电话：+86-400-990-7697
7×24 为服务时间，具体响应、恢复时限及服务条款以合同为准。