當還原的檔案路徑超過最大路徑長度限制 (MAX_PATH) 時,Windows VMware 檔案層級還原 (FLR) 會失敗

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



檔案層級還原工作在某些目錄路徑上失敗,並伴有深度遞迴。      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視窗配置了具有非常深的檔樹結構的 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 個字元。
本地路徑按以下順序構建:驅動器號、冒號、反斜杠、用反斜杠分隔的名稱元件以及終止 null 字元”

Resolution


1.在較新的 Windows 作業系統 (Windows 10 版本 1607 及更新版本) 中,啟用啟用長路徑。     
下列 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.