Avamar: IA 복원 중 Invalid Client-List 오류로 인해 인스턴트 액세스 마운트 해제가 실패함

Summary: ESXi 호스트 NFS(Network File System) 클라이언트가 Data Domain 시스템에 더 이상 존재하지 않기 때문에 Avamar에서 IA(Instant Access) 마운트 해제가 실패하고 "Invalid client-list" 오류가 발생합니다.

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.

Symptoms

인스턴트 액세스 마운트 해제 실패

Avamar에서 IA(Instant Access) 데이터 저장소를 마운트 해제하려고 시도하면 완료되지 않고 오류가 반환됩니다.

  • 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

인스턴트 액세스 마운트 해제 중 발생하는 "Invalid client-list" 오류를 해결하는 단계입니다.

필수 구성 요소

  • Avamar UI에 액세스합니다.
  • SSH를 통해 관리자 권한으로 Data Domain 시스템에 액세스합니다.
  • ESXi 호스트와 Data Domain 어플라이언스 간의 네트워크 연결.

해결 절차

  1. IA(Instant Access) 작업 ID를 식별합니다.
    Avamar UI 사용: 서버 > Data Domain NFS 데이터 저장소. 표시된 IA 작업 ID를 확인합니다.
  2. ESXi 호스트 IP 주소를 확인합니다.
    ESXi 호스트 FQDN(Fully Qualified Domain Name)에 대해 DNS(Domain Name System) 조회를 실행하고 반환된 IP가 호스트와 일치하는지 확인합니다.
    nslookup
  3. Data Domain에서 기존 NFS 클라이언트 매핑을 확인합니다.
    nfs show clients
     ESXi 호스트가 목록에 표시되면 먼저 Avamar UI에서 마운트 해제를 시도합니다. 나타나지 않으면 계속 진행합니다.
  4. Avamar Server DPN(Data Protection Node) ID를 확인합니다.
    avmaint hfscreate
     출력에는 DPN ID가 표시됩니다(예: XXXXXXXXXX(Flash Translation Layer)을 사용하는 데이터 저장 애플리케이션과 시스템에서 일반적으로 수행되는 반복 프로그램과 삭제 사이클로 인해 마모되기 쉽습니다. 이후 단계를 위해 이 값을 기록해 둡니다.
  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 파티션으로 인해 데이터에 액세스할 수 없게 될 수 있습니다. 계속하기 전에 마운트 지점을 확인하십시오.
참고: 단계에 대해 확신이 서지 않거나 이 절차를 수행한 후에도 문제가 지속되면 Dell 지원 부서에 문의하십시오.

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.