Avamar: Falha na desmontagem do acesso instantâneo com o erro Invalid Client-List durante a restauração de IA

Summary: A desmontagem do acesso instantâneo (IA) no Avamar falha com um erro "Invalid client-list" porque o client NFS (Network File System, sistema de arquivos de rede) do host do ESXi não existe mais no 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

Falha na desmontagem do acesso instantâneo

A tentativa de desmontar um datastore de acesso instantâneo (IA) do Avamar não é concluída e retorna um erro.

  • A interface do usuário do Avamar mostra o "Invalid client-list" Mensagem de erro durante a operação de desmontagem.
  • O processo de desmontagem permanece pendente e nunca atinge um estado bem-sucedido.
  • O client NFS associado ao caminho de exportação de IA não é listado ao consultar o sistema Data Domain.

 

Cause

Causa raiz da falha de desmontagem da IA.

A operação de desmontagem do IA falha com o comando Invalid client‑list erro porque o client NFS (host do ESXi) usado para a restauração de IA não está mais presente na configuração do Data Domain.

  • A lista de clients NFS do Data Domain não contém o host do ESXi que iniciou a restauração de IA.
  • Quando o client está ausente, o Data Domain não consegue resolver o caminho de exportação, o que resulta na Invalid client‑list Erro durante a desmontagem.
  • Se a solicitação do /data partição no equipamento Data Domain não está montada, o diretório de exportação IA fica inacessível, o que também pode acionar o mesmo erro.

Exemplo de um client NFS ausente no Data Domain:

# nfs show clients
No NFS clients found.

 

Exemplo de um client NFS presente (para comparação):

# 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

Etapas para resolver o erro "Invalid client-list" durante a desmontagem do acesso instantâneo.

Pré-requisitos

  • Acesso à interface do usuário do Avamar.
  • Acesso SSH ao sistema Data Domain com privilégios administrativos.
  • Conectividade de rede entre o host do ESXi e o equipamento Data Domain.

Procedimento de resolução

  1. Identifique o ID do trabalho de acesso instantâneo (IA).
    Use a interface do usuário do Avamar: Datastores NFS do Data Domain do servidor > . Observe o ID do trabalho de IA exibido.
  2. Confirme o endereço IP do host do ESXi.
    Execute uma pesquisa de DNS (Domain Name System) para o nome de domínio totalmente qualificado (FQDN) do host do ESXi e verifique se o IP retornado corresponde ao host.
    nslookup
  3. Verifique os mapeamentos de client NFS existentes no Data Domain.
    nfs show clients
     Se o host do ESXi aparecer na lista, tente desmontar a partir da interface do usuário do Avamar primeiro. Se não aparecer, continue.
  4. Verifique o ID do DPN (Data Protection Node) do servidor Avamar.
    avmaint hfscreate
     O resultado mostra o ID do DPN (como em, XXXXXXXXXX). Registre esse valor para as etapas posteriores.
  5. Certifique-se de que o /data partição é montada no Data Domain.
    df -h
     Se a solicitação do /data não estiver listado, monte-o:
    mount localhost:/data /data
     Executar novamente df -h para confirmar a montagem.
  6. Localize os metadados de restauração de IA (create.xml).
    Substituir XXXXXXXXXX com o ID de DPN obtido anteriormente.
    cd /data/col1/avamar-XXXXXXXXXX/VMDS/
    ls -l Avamar-MOD-XXXXXXXXXXXXX.vmds.info
    cat Avamar-MOD-XXXXXXXXXXXXX.vmds.info/create.xml
     Se a solicitação do create.xml existe, prossiga. Caso contrário, a exportação de IA já pode estar desembaraçada.
  7. Mapeie o host do ESXi para o caminho de exportação de IA obsoleto.
    Use o caminho de exportação completo e o endereço IP do host do ESXi.
    nfs add /data/col1/avamar-XXXXXXXXXX/VMDS/Avamar-MOD-XXXXXXXXXXXXX
     Observe que o comando está obsoleto. O sistema sugere usar:
    nfs export
     Mas ele ainda cria o mapeamento.

     

  8. Verifique o novo mapeamento de client NFS.
    nfs show clients
     Confirme se o IP do host ESX é exibido com o caminho de exportação e as opções corretas.
  9. Desmonte o datastore NFS do Data Domain na interface do usuário do Avamar.
    Navegue até a entrada do datastore e selecione Unmount. Uma desmontagem bem-sucedida exibe uma tela de confirmação.
  10. Confirme a remoção do client NFS no Data Domain.
  11. Execute o comando client-list novamente:
nfs show clients

O host do ESXi não deve mais ser listado.

Verificação

  • Tente outra IA desmontar do Avamar. A operação deve ser concluída sem o comando "Invalid client‑list" .
  • Verifique se há status limpo na interface do usuário do Avamar no trabalho de IA.
  • Confirme se não existem entradas residuais do client NFS no Data Domain.

 

AVISO: Modificando mapeamentos de client NFS e montando o /data A partição pode afetar as operações de backup ou restauração em andamento. Execute estas etapas durante uma janela de manutenção ou quando o trabalho de IA estiver ocioso.
ADVERTÊNCIA:  Montagem ou desmontagem incorreta do /data A partição pode levar à inacessibilidade dos dados. Verifique o ponto de montagem antes de continuar.
Nota: Se você não tiver certeza sobre qualquer etapa ou se o problema persistir após seguir este procedimento, entre em contato com o Suporte Dell para obter assistência.

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.