Avamar：在 IA 恢复期间，即时访问卸载失败并显示“无效客户端列表”错误

Summary: Avamar 上的即时访问 （IA） 卸载失败，并显示“Invalid client-list”错误，因为 ESXi 主机网络文件系统 （NFS） 客户端不再存在于 Data Domain 系统上。

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Symptoms

即时访问卸载失败

尝试从 Avamar 卸载即时访问 （IA） 数据存储区未完成，并返回错误。

  • Avamar UI 显示 "Invalid client-list" 卸载作期间出现错误消息。
  • 卸载过程保持挂起状态，并且永远不会达到成功状态。
  • 查询 Data Domain 系统时，不会列出与 IA 导出路径关联的 NFS 客户端。

 

Cause

IA 卸载失败的根本原因。

IA 卸载作失败，并显示 Invalid client‑list 错误，因为用于 IA 恢复的 NFS 客户端（ESXi 主机）不再存在于 Data Domain 配置中。

  • Data Domain NFS 客户端列表不包含启动 IA 还原的 ESXi 主机。
  • 缺少客户端时，Data Domain 无法解析导出路径，从而导致 Invalid client‑list 卸载期间出错。
  • 如果必须恢复 /data 未装载 Data Domain 设备上的分区，IA 导出目录变得不可访问，这也可能会触发相同的错误。

Data Domain 上缺少 NFS 客户端的示例：

# nfs show clients
No NFS clients found.

 

当前 NFS 客户端的示例（用于比较）：

# nfs show clients
Path                                            Client          Options
------------------------------------------------ ---------------- ------------------------------
/data/col1/avamar-XXXXXXXXXX/VMDS/Avamar-MOD-XXXXXXXXXXXXX  X.X.X.X  (sec=sys,rw,no_root_squash,no_all_squash,secure,version=3)

Resolution

解决即时访问卸载期间“无效的客户端列表”错误的步骤。

前提条件

  • 访问 Avamar UI。
  • 使用管理权限通过 SSH 访问 Data Domain 系统。
  • ESXi 主机与 Data Domain 数据保护专用存储设备之间的网络连接。

解决方案流程

  1. 识别即时访问 （IA） 作业 ID。
    使用 Avamar UI：服务器 > Data Domain NFS 数据存储区。记下显示的 IA 作业 ID。
  2. 确认 ESXi 主机 IP 地址。
    对 ESXi 主机完全限定域名 （FQDN） 运行域名系统 （DNS） 查找，并验证返回的 IP 是否与主机匹配。 
    nslookup
  3. 检查 Data Domain 上的现有 NFS 客户端映射。 
    nfs show clients
     如果列表中显示 ESXi 主机，请先尝试从 Avamar UI 卸载。如果未显示，请继续。
  4. 验证 Avamar Server 数据保护节点 （DPN） ID。 
    avmaint hfscreate
     输出显示 DPN ID（如 XXXXXXXXXX）时，此方法起作用。记录此值以供后续步骤使用。
  5. 确保 /data 分区已装载到 Data Domain 上。 
    df -h
     如果 /data 未列出，请装载它： 
    mount localhost:/data /data
     重新运行 df -h 以确认装载。
  6. 找到 IA 还原元数据 （create.xml）。
    取代 XXXXXXXXXX 使用之前获取的 DPN ID。 
    cd /data/col1/avamar-XXXXXXXXXX/VMDS/
ls -l Avamar-MOD-XXXXXXXXXXXXX.vmds.info
cat Avamar-MOD-XXXXXXXXXXXXX.vmds.info/create.xml
     如果 create.xml 存在，请继续。否则，IA 导出可能已清除。
  7. 将 ESXi 主机映射到过时的 IA 导出路径。
    使用完整导出路径和 ESXi 主机 IP 地址。 
    nfs add /data/col1/avamar-XXXXXXXXXX/VMDS/Avamar-MOD-XXXXXXXXXXXXX
     请注意，该命令已弃用。系统建议使用： 
    nfs export
     但它仍会创建映射。

     

  8. 验证新的 NFS 客户端映射。 
    nfs show clients
     确认显示 ESX 主机 IP 以及正确的导出路径和选项。
  9. 从 Avamar UI 卸载 Data Domain NFS 数据存储区。
    导航到数据存储条目，然后选择 Unmount。成功卸载将显示确认屏幕。
  10. 确认删除 Data Domain 上的 NFS 客户端。
  11. 再次运行 client-list 命令：
nfs show clients

应不再列出 ESXi 主机。

验证

  • 尝试从 Avamar 卸载另一个 IA。作应在没有 "Invalid client‑list" 错误，请参阅概述的步骤以帮助解决该问题。
  • 检查 Avamar UI 的 IA 作业是否处于清理状态。
  • 确认 Data Domain 上不存在任何剩余的 NFS 客户端条目。

 

注意：修改 NFS 客户端映射并装载 /data 分区可能会影响正在进行的备份或还原作。在维护窗口期间或 IA 作业处于空闲状态时执行这些步骤。
警告： 错误地装载或卸载 /data 分区可能会导致数据无法访问。验证装载点，然后再继续。
提醒：如果您不确定任何步骤，或者在执行此过程后问题仍然存在，请联系戴尔支持以获得帮助。

Affected Products

Avamar
Article Properties
Article Number: 000192087
Article Type: Solution
Last Modified: 23 Oct 2025
Version:  5
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.