Falha na restauração em nível de arquivo (FLR) do Windows VMware quando um caminho de arquivo restaurado excede a limitação de comprimento máximo do caminho (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



Falha no trabalho de restauração em nível de arquivo em determinado caminho de diretório com recursão profunda.      Os logs FLR mostram logs de erros 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 da máquina virtual, o Microsoft Windows é configurado com DFS (Distributed File System) com estruturas de árvore de arquivos muito profundas. 

Ao restaurar para a opção de restauração do local original, vemos no proxy o registro do script FLR (/usr/local/avamarclient/bin/logs/flr*.err) o seguinte:
  
>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: A limitação máxima de comprimento do caminho (MAX_PATH) foi excedida.  Por padrão, esse limite é de 260, o que causará um problema de criação do arquivo de restauração se a combinação do local de salvamento e do caminho do nome do arquivo for maior que 260 caracteres


Mais informações estão disponíveis nesta página da Microsoft: https://docs.microsoft.com/en-us/windows/win32/fileio/naming-a-file

"Na API do Windows (com algumas exceções discutidas nos parágrafos a seguir), o comprimento máximo de um caminho é MAX_PATH, que é definido como 260 caracteres.
Um caminho local é estruturado na seguinte ordem: letra da unidade, dois pontos, barra invertida, componentes de nome separados por barras invertidas e um caractere nulo de terminação"

Resolution


1. Em sistemas operacionais Windows mais recentes (Windows 10, versão 1607 e posterior), habilite Enable Long Paths.     
O seguinte artigo da base de conhecimento da Microsoft tem instruções: https://docs.microsoft.com/en-us/windows/win32/fileio/naming-a-file

OU

2. Em vez de restaurar para o local original, execute uma restauração redirecionada para encurtar o caminho do diretório. 
Exemplo: c:\restore\ que reduzirá o caminho geral do arquivo.  

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.