リストアされたファイル パスが最大パス長制限(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.
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以降)では、長いパスを有効にするを有効にします。     
手順については、次のMicrosoft KB 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.