Восстановление на уровне файлов (FLR) в Windows VMware завершается сбоем, если путь к восстановленному файлу превышает ограничение на длину пути (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



Сбой задания восстановления на уровне файлов на определенном пути каталога с глубокой рекурсией.      В журналах FLR отображаются общие журналы ошибок 

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

Внутри виртуальной машины Microsoft Windows настроена с помощью распределенной файловой системы (DFS) с очень глубокими древовидными структурами файлов. 

При восстановлении в исходное местоположение мы видим на прокси-сервере журнал скрипта FLR (/USR/LOCAL/AVAMARCLIENT/BIN/LOGS/FLR*.ERR) следующее:
  
>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
Проблема. Превышено ограничение максимальной длины пути (MAX_PATH).  По умолчанию это ограничение равно 260, что приводит к проблеме создания файла восстановления, если комбинация места сохранения и пути к имени файла превышает 260 символов


Дополнительные сведения см. на следующей странице Microsoft: https://docs.microsoft.com/en-us/windows/win32/fileio/naming-a-file

"В Windows API (за некоторыми исключениями, описанными в следующих параграфах) максимальная длина пути составляет MAX_PATH, что составляет 260 символов.
Локальный путь структурирован в следующем порядке: буква диска, двоеточие, обратная косая черта, компоненты имени, разделенные обратной косой чертой, и завершающий его нулевой символ.

Resolution


1. В более новых операционных системах Windows (Windows 10 версии 1607 и более поздних) включите параметр Enable Long Paths.     
В следующей статье базы знаний Microsoft содержатся инструкции: https://docs.microsoft.com/en-us/windows/win32/fileio/naming-a-file

ИЛИ

2. Вместо восстановления в исходное местоположение выполните перенаправленное восстановление в путь сокращения каталога. 
Пример: c:\restore\, что уменьшит общий путь к файлу.  

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.