La restauración a nivel de archivos (FLR) de Windows VMware falla cuando una ruta de archivo restaurada supera el límite máximo de longitud de ruta (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



El trabajo de restauración a nivel de archivos falla en cierta ruta de directorio con recursividad profunda.      Los registros de FLR muestran registros de errores genéricos 

  
--------------------------------------------------------------------------------------------------------
-----  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

Dentro de la máquina virtual, Microsoft Windows está configurado con DFS (sistema de archivos distribuido) con estructuras de árbol de archivos muy profundas. 

Cuando se restaura a la opción de restauración de la ubicación original, vemos en el proxy el registro del script de FLR (/usr/local/avamarclient/bin/logs/flr*.err) lo siguiente:
  
>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
Problema: Se superó el límite máximo de longitud de ruta (MAX_PATH).  De manera predeterminada, este límite es 260, lo que causa un problema de creación de archivos de restauración si la combinación de la ubicación de guardado y la ruta del nombre de archivo es superior a 260 caracteres


Hay más información disponible en esta página de Microsoft: https://docs.microsoft.com/en-us/windows/win32/fileio/naming-a-file

"En la API de Windows (con algunas excepciones que se analizan en los siguientes párrafos), la longitud máxima de una ruta es MAX_PATH, que se define como 260 caracteres.
Una ruta local se estructura en el siguiente orden: letra de unidad, dos puntos, barra invertida, componentes de nombre separados por barras invertidas y un carácter nulo de terminación"

Resolution


1. En los sistemas operativos Windows más recientes (Windows 10, versión 1607 y posteriores), habilite Habilitar rutas largas.     
El siguiente artículo de la base de conocimientos de Microsoft tiene instrucciones: https://docs.microsoft.com/en-us/windows/win32/fileio/naming-a-file

O

2. En lugar de restaurar a la ubicación original, realice una restauración redirigida en una ruta de directorio más corta. 
Por ejemplo: c:\restore\ que reducirá la ruta de archivo general.  

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.