Avamar: A restauração em nível de arquivo do VMware pode falhar devido à configuração de NAT

Summary: Este artigo da base de conhecimento tem como objetivo abordar os problemas observados ao usar a FLR (File Level Restore, restauração em nível de arquivo) do Avamar com NAT (Network Address Translation, conversão de endereços de rede). As operações de FLR podem falhar devido a incompatibilidades de IP causadas por NAT. ...

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

  • Inicialmente, os trabalhos de FLR são iniciados, mas não são concluídos.
  • Arquivos menores (como 20 KB a 2,7 MB) são restaurados com sucesso, mas arquivos maiores (por exemplo, 25 MB ou 90 MB) falham.
  • Esse problema afeta a restauração em nível de arquivo de todas as máquinas virtuais nesse ambiente específico.
  • Erros 500 do servidor HTTP (Jetty) são exibidos nos registros de acesso durante as tentativas de restauração.
  • O log de acesso do jetty mostra endereços IP incomuns (por exemplo, o IP do client terminando em 0.1 ou 0.254, que provavelmente é um endereço de gateway).

Cause

O problema surge da maneira como a FLR lida com as operações de transferência de arquivos, dependendo do tamanho do trabalho:

  1. Pequenos trabalhos de restauração:

    • Quando o trabalho FLR transfere uma pequena quantidade de dados (total de bytes < de 5 MB e total de arquivos < de 10), ele usa a API do vSphere para restaurar arquivos. As transferências de arquivos da API do vSphere ignoram as configurações de NAT da VM, pois a rede convidada da VM não está envolvida na transferência.

  2. Grandes trabalhos de restauração:

    • Para trabalhos FLR maiores que superam os critérios do trabalho de restauração minúsculo, o Avamar passa a usar scripts wget/BatchDownload seguros para transferir arquivos com mais eficiência.
    • Esse método cria arquivos e tokens temporários para gerenciar a transferência segura, que depende do endereço IP do client corresponder a um valor esperado.

Quando o NAT está ativado na rede, ele altera o endereço IP de origem do client na solicitação. Isso causa uma disparidade entre o IP do client armazenado na tabela de tokens e o endereço IP a partir do qual a solicitação é feita. Portanto, o processo de verificação de token falha, levando a uma falha na restauração do arquivo.

    Resolution

    O uso de NAT com FLR do Avamar não é compatível. Estas são as etapas recomendadas:

    1. Desative o DNAT:

      • Trabalhe com a equipe de rede para desabilitar o DNAT para o ambiente em que a FLR do Avamar está sendo usada. Essa é a maneira mais eficaz de garantir que as operações de FLR possam prosseguir sem disparidades de endereço IP.

    2. Identifique se o DNAT está ativado:

      • Confirme com a equipe de rede se o DNAT está ativado. Os registros de exemplo podem mostrar IPs de origem incompatíveis, como 192.168.1.1, que pode ser o IP do gateway devido ao DNAT.

    3. Solução temporária: desative o fluxo de trabalho BatchDownload.exe/wget:

    Como solução temporária, você pode desativar o fluxo de trabalho do BatchDownload.exe e forçar a FLR a usar operações de arquivo convidado do vSphere. Isso afeta a velocidade das operações de FLR, tornando-as mais lentas.
    I. No proxy, edite o arquivo de configuração: 
    /usr/local/avamarclient/bin/config.xml
    II.  Altere a seguinte linha de: 
    <enablewgetrestore>1</enablewgetrestore>
    Para isso:  
    <enablewgetrestore>0</enablewgetrestore>

    III. Depois de fazer a alteração de configuração, reinicie o vmwareflr.service. 
    systemctl restart vmwareflr && systemctl restart avagent.service
         

    Affected Products

    Avamar
    Article Properties
    Article Number: 000283981
    Article Type: Solution
    Last Modified: 22 May 2025
    Version:  2
    Find answers to your questions from other Dell users
    Support Services
    Check if your device is covered by Support Services.