Avamar : La restauration en mode fichier VMware peut échouer en raison de la configuration NAT

Summary: Cet article de la base de connaissances vise à résoudre les problèmes rencontrés lors de l’utilisation d’Avamar File Level Restore (FLR) avec la traduction d’adresses réseau (NAT). Les opérations FLR peuvent échouer en raison d’incompatibilités d’adresses IP causées par 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.

Symptoms

  • Les tâches FLR démarrent initialement, mais ne se terminent pas.
  • Les fichiers plus petits (par exemple, 20 Ko à 2,7 Mo) sont restaurés avec succès, mais les fichiers plus volumineux (par exemple, 25 Mo ou 90 Mo) échouent.
  • Ce problème affecte la restauration en mode fichier de toutes les machines virtuelles dans cet environnement particulier.
  • Des erreurs de serveur HTTP (Jetty) 500 s’affichent dans les journaux d’accès lors des tentatives de restauration.
  • Le journal d’accès Jetty affiche des adresses IP inhabituelles (par exemple, l’adresse IP du client se terminant par 0.1 ou 0.254, qui est probablement une adresse de passerelle).

Cause

Le problème provient de la façon dont FLR gère les opérations de transfert de fichiers, en fonction de la taille de la tâche :

  1. Tâches de restauration miniatures :

    • Lorsque la tâche FLR transfère une petite quantité de données (5 Mo au total d’octets < et 10 au total de fichiers < ), elle utilise l’API vSphere pour restaurer les fichiers. Les transferts de fichiers de l’API vSphere contournent les configurations NAT des machines virtuelles, car le réseau invité de la machine virtuelle n’est pas impliqué dans le transfert.
  2. Tâches de restauration volumineuses :

    • Pour les tâches FLR plus volumineuses qui dépassent les critères des tâches de restauration minimales, Avamar utilise des scripts sécurisés wget/BatchDownload pour transférer les fichiers plus efficacement.
    • Cette méthode crée des jetons et des fichiers temporaires pour gérer le transfert sécurisé, qui s’appuie sur l’adresse IP du client correspondant à une valeur attendue.

Lorsque NAT est activé sur le réseau, il modifie l’adresse IP source du client dans la demande. Cela entraîne une incompatibilité entre l’adresse IP du client stockée dans la table de jetons et l’adresse IP à partir de laquelle la demande est effectuée. Par conséquent, le processus de vérification du jeton échoue, entraînant l’échec de la restauration des fichiers.

    Resolution

    L’utilisation de NAT avec Avamar FLR n’est pas prise en charge. Voici les étapes recommandées :

    1. Désactivez DNAT :

      • Collaborez avec l’équipe réseau pour désactiver DNAT pour l’environnement dans lequel Avamar FLR est utilisé. Il s’agit du moyen le plus efficace de s’assurer que les opérations de FLR peuvent se poursuivre sans incompatibilités d’adresses IP.
    2. Identifiez si DNAT est activé :

      • Confirmez auprès de l’équipe réseau si le DNAT est activé. Les exemples de journaux peuvent afficher des adresses IP source incompatibles telles que 192.168.1.1, qui peuvent être l’adresse IP de la passerelle en raison de DNAT.
    3. Solution de contournement : désactivez le workflow BatchDownload.exe/wget :

    Pour contourner ce problème, vous pouvez désactiver le workflow BatchDownload.exe et forcer FLR à utiliser les opérations de fichiers invités vSphere à la place. Cela a un impact sur la vitesse des opérations FLR, ce qui les ralentit.
    I. Sur le proxy, modifiez le fichier de configuration :
    /usr/local/avamarclient/bin/config.xml
    II.  Remplacez la ligne suivante à partir de :
    <enablewgetrestore>1</enablewgetrestore>
    À cela : 
    <enablewgetrestore>0</enablewgetrestore>

    III. Après avoir modifié la configuration, redémarrez 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.