Avamar: L'annullamento dello smontaggio dell'accesso istantaneo ha esito negativo con errore Invalid Client-List durante il ripristino IA

Summary: L'unmount dell'accesso istantaneo (IA) su Avamar ha esito negativo con un errore "Invalid client-list" perché il client NFS (Network File System) dell host ESXi non esiste più nel sistema 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.

Symptoms

Errore di disinstallazione accesso istantaneo

Il tentativo di disinstallare un datastore Instant Access (IA) da Avamar non viene completato e restituisce un errore.

  • L'interfaccia utente di Avamar mostra "Invalid client-list" Messaggio di errore durante l'operazione di disinstallazione.
  • Il processo di disinstallazione rimane in sospeso e non raggiunge mai uno stato di esito positivo.
  • Il client NFS associato al percorso di esportazione IA non viene elencato quando si esegue una query sul sistema Data Domain.

 

Cause

Root cause dell'errore di disinstallazione dell'IA.

L'operazione di smontaggio dell'IA ha esito negativo con il Invalid client‑list errore perché il client NFS (host ESXi) utilizzato per il ripristino IA non è più presente nella configurazione di Data Domain.

  • L'elenco dei client NFS di Data Domain non contiene l'host ESXi che ha avviato il restore IA.
  • Se il client è mancante, Data Domain non è in grado di risolvere il percorso di esportazione, causando Invalid client‑list errore durante l'unmount.
  • Se /data La partizione sull'appliance Data Domain non è montata, la directory di esportazione IA diventa inaccessibile, il che può anche attivare lo stesso errore.

Esempio di client NFS mancante su Data Domain:

# nfs show clients
No NFS clients found.

 

Esempio di client NFS presente (per un confronto):

# 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

Procedura per risolvere l'errore "Invalid client-list" durante l'unmount ad accesso istantaneo.

Prerequisiti

  • Accesso all'interfaccia utente di Avamar.
  • Accesso SSH al sistema Data Domain con privilegi di amministratore.
  • Connettività di rete tra l'host ESXi e l'appliance Data Domain.

Procedura di risoluzione

  1. Identificare l'ID del processo di accesso istantaneo (IA).
    Utilizzare l'interfaccia utente di Avamar: Datastore NFS Server > Data Domain. Prendere nota dell'ID del processo IA visualizzato.
  2. Confermare l'indirizzo IP dell'host ESXi.
    Eseguire una ricerca DNS (Domain Name System) per il nome di dominio completo (FQDN) dell'host ESXi e verificare che l'IP restituito corrisponda all'host.
    nslookup
  3. Controllare i mapping dei client NFS esistenti in Data Domain.
    nfs show clients
     Se l'host ESXi viene visualizzato nell'elenco, tentare prima un unmount dall'interfaccia utente di Avamar. Se non viene visualizzato, continuare.
  4. Verificare l'ID del nodo di protezione dei dati (DPN) dell'Avamar Server.
    avmaint hfscreate
     L'output mostra l'ID DPN (come in, XXXXXXXXXX). Registrare questo valore per i passaggi successivi.
  5. Assicurarsi che il /data La partizione è montata su Data Domain.
    df -h
     Se /data non è elencato, montarlo:
    mount localhost:/data /data
     Esegui di nuovo df -h per confermare il montaggio.
  6. Individuare i metadati di ripristino IA (create.xml).
    Sostituire XXXXXXXXXX con l'ID DPN ottenuto in precedenza.
    cd /data/col1/avamar-XXXXXXXXXX/VMDS/
    ls -l Avamar-MOD-XXXXXXXXXXXXX.vmds.info
    cat Avamar-MOD-XXXXXXXXXXXXX.vmds.info/create.xml
     Se create.xml esiste, procedere. In caso contrario, l'esportazione IA potrebbe essere già stata cancellata.
  7. Eseguire il mapping dell'host ESXi al percorso di esportazione IA non aggiornato.
    Utilizzare il percorso di esportazione completo e l'indirizzo IP dell'host ESXi.
    nfs add /data/col1/avamar-XXXXXXXXXX/VMDS/Avamar-MOD-XXXXXXXXXXXXX
     Si noti che il comando è obsoleto. Il sistema suggerisce di utilizzare:
    nfs export
     Ma crea comunque la mappatura.

     

  8. Verificare il mapping del nuovo client NFS.
    nfs show clients
     Verificare che l'IP dell host ESX sia visualizzato con il percorso di esportazione e le opzioni corretti.
  9. Smontare il datastore NFS di Data Domain dall'interfaccia utente di Avamar.
    Passare alla voce del datastore e selezionare Unmount. Se l'unmount viene eseguito correttamente, viene visualizzata una schermata di conferma.
  10. Confermare la rimozione del client NFS su Data Domain.
  11. Eseguire nuovamente il comando client-list:
nfs show clients

L'host ESXi non deve più essere elencato.

Verifica

  • Tentare un altro unmount IA da Avamar. L'operazione deve essere completata senza "Invalid client‑list" trovata.
  • Controllare l'interfaccia utente di Avamar per uno stato pulito sul processo IA.
  • Verificare che non esistano voci client NFS residue in Data Domain.

 

ATTENZIONE: Modifica dei mapping dei client NFS e mounting di /data La partizione può influire sulle operazioni di backup o ripristino in corso. Eseguire questi passaggi durante una finestra di manutenzione o quando il processo IA è inattivo.
AVVERTENZA:  Montaggio o disinstallazione errato di /data La partizione può causare l'inaccessibilità dei dati. Verificare il mount point prima di procedere.
NOTA: In caso di dubbi su qualsiasi passaggio o se il problema persiste dopo aver seguito questa procedura, contattare il Supporto Dell per assistenza.

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.