Avamar: El desmontaje de acceso instantáneo falla con el error Invalid Client-List durante la restauración de IA

Summary: El desmontaje del acceso instantáneo (IA) en Avamar falla con el error "Invalid client-list" debido a que el cliente Network File System (NFS) del host ESXi ya no existe en el 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.
Check out other resources

Symptoms

Falla de desmontaje de acceso instantáneo

El intento de desmontar un almacén de datos de acceso instantáneo (IA) de Avamar no se completa y arroja un error.

  • La interfaz de usuario de Avamar muestra la "Invalid client-list" Mensaje de error durante la operación de desmontaje.
  • El proceso de desmontaje permanece pendiente y nunca llega a un estado correcto.
  • El cliente NFS asociado con la ruta de exportación de IA no aparece en la lista cuando se consulta el sistema Data Domain.

 

Cause

Causa raíz de la falla de desmontaje de IA.

La operación de desmontaje de IA falla con el comando Invalid client‑list debido a que el cliente NFS (host ESXi) que se utiliza para la restauración de IA ya no está presente en la configuración de Data Domain.

  • La lista de clientes NFS de Data Domain no contiene el host ESXi que inició la restauración de IA.
  • Cuando falta el cliente, Data Domain no puede resolver la ruta de exportación, lo que da lugar a la Invalid client‑list Error durante el desmontaje.
  • Si la solicitud en /data La partición en el dispositivo Data Domain no está montada, el directorio de exportación de IA se vuelve inaccesible, lo que también puede desencadenar el mismo error.

Ejemplo de un cliente NFS faltante en Data Domain:

# nfs show clients
No NFS clients found.

 

Ejemplo de un cliente NFS actual (a modo de comparación):

# 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

Pasos para resolver el error "Invalid client-list" durante el desmontaje de acceso instantáneo.

Requisitos previos

  • Acceso a la interfaz de usuario de Avamar.
  • Acceso mediante SSH al sistema Data Domain con privilegios administrativos.
  • Conectividad de red entre el host ESXi y el dispositivo Data Domain.

Procedimiento de resolución

  1. Identifique el ID de trabajo de acceso instantáneo (IA).
    Utilice la interfaz de usuario de Avamar: Almacenes de datos NFS de Server > Data Domain. Anote el ID de trabajo de IA que se muestra.
  2. Confirme la dirección IP del host ESXi.
    Ejecute una búsqueda en el Sistema de nombres de dominio (DNS) del nombre de dominio calificado (FQDN) del host ESXi y verifique que la IP devuelta coincida con el host. 
    nslookup
  3. Compruebe los mapeos de clientes NFS existentes en Data Domain. 
    nfs show clients
     Si el host ESXi aparece en la lista, intente primero desmontarlo desde la interfaz de usuario de Avamar. Si no aparece, continúe.
  4. Verifique el ID del nodo de protección de datos (DPN) del servidor Avamar. 
    avmaint hfscreate
     El resultado muestra el ID del DPN (como en, XXXXXXXXXX). Registre este valor para pasos posteriores.
  5. Asegúrese de que el /data la partición está montada en Data Domain. 
    df -h
     Si la solicitud en /data no aparece en la lista, móntelo: 
    mount localhost:/data /data
     Volver a ejecutar df -h para confirmar el montaje.
  6. Busque los metadatos de restauración de IA (create.xml).
    Reemplazar XXXXXXXXXX con el ID de DPN obtenido anteriormente. 
    cd /data/col1/avamar-XXXXXXXXXX/VMDS/
ls -l Avamar-MOD-XXXXXXXXXXXXX.vmds.info
cat Avamar-MOD-XXXXXXXXXXXXX.vmds.info/create.xml
     Si la solicitud en create.xml existe, continúe. De lo contrario, es posible que la exportación de IA ya se haya borrado.
  7. Asigne el host ESXi a la ruta de exportación de IA obsoleta.
    Utilice la ruta de exportación completa y la dirección IP del host ESXi. 
    nfs add /data/col1/avamar-XXXXXXXXXX/VMDS/Avamar-MOD-XXXXXXXXXXXXX
     Tenga en cuenta que el comando está obsoleto. El sistema sugiere usar: 
    nfs export
     Pero aun así crea el mapeo.

     

  8. Verifique la asignación del nuevo cliente NFS. 
    nfs show clients
     Confirme que la IP del host ESX aparezca con las opciones y la ruta de exportación correctas.
  9. Desmonte el almacén de datos NFS de Data Domain desde la interfaz de usuario de Avamar.
    Vaya a la entrada del almacén de datos y seleccione Unmount. Un desmontaje correcto muestra una pantalla de confirmación.
  10. Confirme la eliminación del cliente NFS en Data Domain.
  11. Vuelva a ejecutar el comando client-list:
nfs show clients

El host ESXi ya no debe aparecer en la lista.

Verificación

  • Intente otro desmontaje de IA en Avamar. La operación debe completarse sin el "Invalid client‑list" error.
  • Compruebe la interfaz del usuario de Avamar para obtener un estado limpio en el trabajo de IA.
  • Confirme que no existan entradas residuales del cliente NFS en Data Domain.

 

ADVERTENCIA: Modificación de mapeos de clientes NFS y montaje de /data La partición puede afectar las operaciones de respaldo o restauración en curso. Realice estos pasos durante una ventana de mantenimiento o cuando el trabajo de IA esté inactivo.
PRECAUCIÓN:  Montaje o desmontaje incorrecto del /data La partición puede provocar la inaccesibilidad de los datos. Verifique el punto de montaje antes de continuar.
NOTA: Si no está seguro acerca de algún paso, o si el problema persiste después de seguir este procedimiento, comuníquese con el soporte de Dell para obtener ayuda.

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.