Avamar: Instant Access Unmount mislukt met Invalid Client-List-fout tijdens IA-herstel

Summary: Instant Access (IA) ontkoppelen op Avamar mislukt met de fout "Invalid client-list" omdat de ESXi-host Network File System (NFS)-client niet meer bestaat op het Data Domain systeem.

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

Fout bij het ontkoppelen van directe toegang

Een poging om een IA-datastore (Instant Access) van Avamar te ontkoppelen mislukt en retourneert een fout.

  • In de Avamar UI wordt het volgende weergegeven: "Invalid client-list" foutmelding tijdens het ontkoppelen.
  • Het ontkoppelingsproces wordt nog in behandeling genomen en bereikt nooit een succesvolle status.
  • De NFS-client die is gekoppeld aan het IA-exportpad wordt niet vermeld bij het uitvoeren van query's op het Data Domain-systeem.

 

Cause

Hoofdoorzaak van IA Unmount Failure.

De bewerking voor het ontkoppelen van de IA mislukt met de Invalid client‑list fout omdat de NFS-client (ESXi-host) die wordt gebruikt voor het IA-herstel niet meer aanwezig is in de Data Domain-configuratie.

  • De Data Domain NFS-clientlijst bevat niet de ESXi-host waarmee de IA-herstel is gestart.
  • Wanneer de client ontbreekt, kan Data Domain het exportpad niet oplossen, wat resulteert in het Invalid client‑list Fout tijdens ontkoppelen.
  • Als de /data partitie op de Data Domain-appliance niet is gekoppeld, wordt de IA-exportmap ontoegankelijk, wat ook dezelfde fout kan veroorzaken.

Voorbeeld van een ontbrekende NFS-client op Data Domain:

# nfs show clients
No NFS clients found.

 

Voorbeeld van een huidige NFS-client (ter vergelijking):

# 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

Stappen om de fout "Invalid client-list" op te lossen tijdens het ontkoppelen van Instant Access.

Vereisten

  • Toegang tot de Avamar UI.
  • SSH-toegang tot het Data Domain systeem met beheerdersrechten.
  • Netwerkconnectiviteit tussen de ESXi-host en de Data Domain-appliance.

Besluitvormingsprocedure

  1. Identificeer de IA-taak-ID (Instant Access).
    De gebruikersinterface van Avamar gebruiken: Server > Data Domain NFS-datastores. Let op de weergegeven IA-taak-ID.
  2. Bevestig het IP-adres van de ESXi-host.
    Voer een DNS-zoekopdracht (Domain Name System) uit voor de volledig gekwalificeerde domeinnaam (FQDN) van de ESXi-host en controleer of het geretourneerde IP-adres overeenkomt met de host. 
    nslookup
  3. Bestaande NFS-clienttoewijzingen op Data Domain controleren. 
    nfs show clients
     Als de ESXi-host in de lijst wordt weergegeven, moet u eerst proberen de koppeling te verwijderen vanuit de Avamar UI. Als het niet verschijnt, gaat u verder.
  4. Controleer de ID van het databeschermingsknooppunt (DPN) van de Avamar-server. 
    avmaint hfscreate
     De uitvoer toont de DPN-ID (zoals in, XXXXXXXXXX). Noteer deze waarde voor latere stappen.
  5. Zorg ervoor dat de /data partitie is gekoppeld aan Data Domain. 
    df -h
     Als /data staat er niet bij, mount it: 
    mount localhost:/data /data
     Opnieuw uitvoeren df -h om de bevestiging te bevestigen.
  6. Zoek de IA-herstelmetadata (create.xml).
    Vervangen XXXXXXXXXX met de eerder verkregen DPN-ID. 
    cd /data/col1/avamar-XXXXXXXXXX/VMDS/
ls -l Avamar-MOD-XXXXXXXXXXXXX.vmds.info
cat Avamar-MOD-XXXXXXXXXXXXX.vmds.info/create.xml
     Als create.xml bestaat, ga dan verder. Zo niet, dan is de IA-uitvoer mogelijk al ingeklaard.
  7. Wijs de ESXi-host toe aan het verouderde IA-exportpad.
    Gebruik het volledige exportpad en het IP-adres van de ESXi-host. 
    nfs add /data/col1/avamar-XXXXXXXXXX/VMDS/Avamar-MOD-XXXXXXXXXXXXX
     Merk op dat de opdracht verouderd is. Het systeem stelt voor om het volgende te gebruiken: 
    nfs export
     Maar het creëert nog steeds de mapping.

     

  8. Controleer de toewijzing van de nieuwe NFS-client. 
    nfs show clients
     Controleer of het IP-adres van de ESX-host wordt weergegeven met het juiste exportpad en de juiste opties.
  9. Ontkoppel de Data Domain NFS-datastore vanuit de Avamar UI.
    Navigeer naar de datastore-vermelding en selecteer Ontkoppelen. Als de ontkoppeling is voltooid, wordt een bevestigingsscherm weergegeven.
  10. Bevestig de verwijdering van de NFS-client op Data Domain.
  11. Voer de opdracht client-list opnieuw uit:
nfs show clients

De ESXi-host mag niet langer worden vermeld.

Controle

  • Probeer nog een IA te ontkoppelen van Avamar. De bewerking moet worden voltooid zonder het "Invalid client‑list" ontvangt.
  • Controleer de Avamar UI op een schone status voor de IA-taak.
  • Controleer of er geen resterende NFS-clientvermeldingen bestaan op Data Domain.

 

LET OP: Modifying NFS client mappings en mounting /data Partitie kan van invloed zijn op lopende back-up- of herstelbewerkingen. Voer deze stappen uit tijdens een onderhoudsvenster of wanneer de IA-taak inactief is.
WAARSCHUWING:  Onjuiste montage of demontage van de /data Partitionering kan leiden tot niet-toegankelijkheid van data. Controleer het koppelpunt voordat u verdergaat.
OPMERKING: Als u twijfelt over een bepaalde stap of als het probleem zich blijft voordoen na het volgen van deze procedure, neemt u contact op met Dell Support voor hulp.

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.