La restauration en mode fichier (FLR) VMware Windows échoue lorsqu’un chemin de fichier restauré dépasse la limite de longueur maximale de chemin (MAX_PATH)

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



Échec de la tâche de restauration en mode fichier sur un certain chemin de répertoire avec récursivité profonde.      Les journaux FLR affichent des journaux d’erreurs génériques 

  
--------------------------------------------------------------------------------------------------------
-----  START avvmwfile log <timestamp> UTC  [18.2.100-134 Linux-x86_64]
--------------------------------------------------------------------------------------------------------

<timestamp> avvmwfile Info <5008>: Logging to /usr/local/avamarclient/var/MOD-1565970042058-<cid>-3019-vmwfilew.log
<timestamp> avvmwfile Info <5174>: - Reading /usr/local/avamarclient/var/avvmwfile.cmd
<timestamp> avvmwfile Info <5174>: - Reading /usr/local/avamarclient/var/avvmwfileAll.cmd
<timestamp> avvmwfile Info <6673>: CTL listening on port 34258
<timestamp> avvmwfile Info <10684>: Setting ctl message version to 3 (from 1)
<timestamp> avvmwfile Info <16136>: Setting ctl max message size to 268435456
<timestamp> avvmwfile Info <5174>: - Reading /usr/local/avamarclient/var/avvmwfile.cmd
<timestamp> avvmwfile Info <5174>: - Reading /usr/local/avamarclient/var/avvmwfileAll.cmd
<timestamp> avvmwfile Info <19660>: targetlist contains <dir backup="true" date="1969-01-01 00:00:00" internal="0" group="unknown" protection="drwx------" name="C:/DFS_Shares/Users/Bob" size="65536" saveas="C:/DFS_Shares/users/restore" user="unknown" />

<timestamp> avvmwfile Error <0000>: Failed to restore files via network, check proxy log for details
<timestamp>  avvmwfile Error <0000>: assist_restore error. ret: 157

--------------------------------------------------------------------------------------------------------
----- END avvmwfile log <timestamp> UTC  (0 warnings, 2 errors, 0 fatal errors)
--------------------------------------------------------------------------------------------------------

 

Cause

À l’intérieur de la machine virtuelle, Microsoft Windows est configuré avec DFS (Distributed File System) avec des structures arborescentes de fichiers très profondes. 

Lors de la restauration vers l’option de restauration à l’emplacement d’origine, le fichier log du script FLR sur le proxy (/usr/local/avamarclient/bin/logs/flr*.err) contient les informations suivantes :
  
>file name: file1.txt
>file name: files2 
>file name: <long-file>-example.txt
>fail to create file  C:\DFS_Shares\users\restore\folder1\folder2\folder3\....< file length bigger than 260 characters>-example.txt  error code:2
Problème : La limite maximale de longueur de chemin (MAX_PATH) a été dépassée.  Par défaut, cette limite est de 260, ce qui entraîne un problème de création de fichier de restauration si la combinaison de l’emplacement d’enregistrement et du chemin du nom de fichier est supérieure à 260 caractères


Plus d’informations sont disponibles sur cette page Microsoft : https://docs.microsoft.com/en-us/windows/win32/fileio/naming-a-file

« Dans l’API Windows (à quelques exceptions près abordées dans les paragraphes suivants), la longueur maximale d’un chemin d’accès est de MAX_PATH, qui est définie comme étant de 260 caractères.
Un chemin local est structuré dans l’ordre suivant : lettre de lecteur, deux-points, barre oblique inverse, composants de nom séparés par des barres obliques inverses et caractère nul de fin. »

Resolution


1. Dans les systèmes d’exploitation Windows plus récents (Windows 10, version 1607 et versions ultérieures), activez l’option Activer les chemins longs.     
La base de connaissances Microsoft suivante contient des instructions : https://docs.microsoft.com/en-us/windows/win32/fileio/naming-a-file

OU

2. Au lieu d’effectuer une restauration à l’emplacement d’origine, effectuez une restauration redirigée vers un chemin d’accès raccourci au répertoire. 
Exemple : c :\restore\ qui réduira le chemin d’accès global au fichier.  

Affected Products

Avamar

Products

Avamar, Avamar Client for VMware
Article Properties
Article Number: 000053607
Article Type: Solution
Last Modified: 09 Oct 2024
Version:  3
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.