Can't perform a file operation from a UNIX client to a Windows Server 2008-based NFS server

Symptoms

Consider the following scenario:
  • You have a network file system (NFS) share on a Windows Server 2008-based NFS server.
  • You use a UNIX client that does not support 64-bit cookies to access files in the NFS share. 
  • You try to perform a file operation from the UNIX client. For example, you try to run the tar command to archive files, or you try to run the ls command to list files in a directory.
In this scenario, the file operation fails. For example, duplicate file names are displayed or the command falls in to an infinite loop.

Cause

This issue occurs because duplicate cookies are generated and returned to the UNIX client by the NFS server.

Note In a directory that contains many New Technology File System (NTFS) hard links to the same file, duplicate cookie issues can occur. To avoid duplicate cookie issues, NFS server uses file name hashing in the cookie generating algorithm. This may result in duplicate cookies when many files have similar file names in a NFS share.

Resolution

Hotfix information

A supported hotfix is available from Microsoft. However, this hotfix is intended to correct only the problem that is described in this article. Apply this hotfix only to systems that are experiencing the problem described in this article. This hotfix might receive additional testing. Therefore, if you are not severely affected by this problem, we recommend that you wait for the next software update that contains this hotfix.

If the hotfix is available for download, there is a "Hotfix download available" section at the top of this Knowledge Base article. If this section does not appear, contact Microsoft Customer Service and Support to obtain the hotfix.

Note If additional issues occur or if any troubleshooting is required, you might have to create a separate service request. The usual support costs will apply to additional support questions and issues that do not qualify for this specific hotfix. For a complete list of Microsoft Customer Service and Support telephone numbers or to create a separate service request, visit the following Microsoft website: Note The "Hotfix download available" form displays the languages for which the hotfix is available. If you do not see your language, it is because a hotfix is not available for that language.

Prerequisites

To apply this hotfix, you must be running Windows Server 2008 Service Pack 2 (SP2).

For more information about how to obtain a Windows Server 2008 service pack, click the following article number to view the article in the Microsoft Knowledge Base:

968849 How to obtain the latest service pack for Windows Server 2008

Registry information

Important This section, method, or task contains steps that tell you how to modify the registry. However, serious problems might occur if you modify the registry incorrectly. Therefore, make sure that you follow these steps carefully. For added protection, back up the registry before you modify it. Then, you can restore the registry if a problem occurs. For more information about how to back up and restore the registry, click the following article number to view the article in the Microsoft Knowledge Base:
322756 How to back up and restore the registry in Windows
After apply this hotfix, you must create a registry key to disable file name hashing for cookies on NFS version 2 server or NFS version 3 server. To do this, follow these steps:
  1. Click Startstart button , type regedit in the Search programs and files box, and then press ENTER.
    UAC If you are prompted for an administrator password, type the password. If you are prompted for confirmation, provide confirmation.
  2. Locate and then click the following registry subkey:
    HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\NfsServer\Parameters
  3. On the Edit menu, point to New, and then click DWORD Value.
  4. Type DisableFilenameHashing, and then press ENTER.
  5. Right-click DisableFilenameHashing, and then click Modify.
  6. In the Value data box, type 1, and then click OK.
  7. Exit Registry Editor.
Notes
  • You can use the DisableFilenameHashing registry entry to control if the file name hashing is used or not when NFS server generates cookies. You can set the DWORD value of the DisableFilenameHashing registry entry to 0 to enable the file name hashing.
  • Please do not disable the file name hashing if the NFS share contains many NFS hard links that point to the same file.

Restart requirement

You must restart the computer after you apply this hotfix.

Hotfix replacement information

This hotfix does not replace a previously released hotfix.
File information

Status

Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section.

More Information

For more information about software update terminology, click the following article number to view the article in the Microsoft Knowledge Base:

824684 Description of the standard terminology that is used to describe Microsoft software updates

Additional file information

Additional file information for Windows Server 2008

Additional files for all supported x86-based versions of Windows Server 2008
File nameX86_microsoft-windows-n..enamehashing-regkey_31bf3856ad364e35_6.0.6002.23087_none_c75d385f91cf5b3e.manifest
File versionNot applicable
File size1,409
Date (UTC)06-Apr-2013
Time (UTC)02:59
PlatformNot applicable
File nameX86_microsoft-windows-nfs-servercore_31bf3856ad364e35_6.0.6002.23087_none_5dc526d11dca4cc4.manifest
File versionNot applicable
File size50,906
Date (UTC)06-Apr-2013
Time (UTC)03:00
PlatformNot applicable
Additional files for all supported x64-based versions of Windows Server 2008
File nameAmd64_microsoft-windows-n..enamehashing-regkey_31bf3856ad364e35_6.0.6002.23087_none_237bd3e34a2ccc74.manifest
File versionNot applicable
File size1,411
Date (UTC)06-Apr-2013
Time (UTC)03:56
PlatformNot applicable
File nameAmd64_microsoft-windows-nfs-servercore_31bf3856ad364e35_6.0.6002.23087_none_b9e3c254d627bdfa.manifest
File versionNot applicable
File size50,940
Date (UTC)06-Apr-2013
Time (UTC)03:58
PlatformNot applicable
Additional files for all supported IA-64-based versions of Windows Server 2008
File nameIa64_microsoft-windows-n..enamehashing-regkey_31bf3856ad364e35_6.0.6002.23087_none_c75edc5591cd643a.manifest
File versionNot applicable
File size1,410
Date (UTC)06-Apr-2013
Time (UTC)02:30
PlatformNot applicable
File nameIa64_microsoft-windows-nfs-servercore_31bf3856ad364e35_6.0.6002.23087_none_5dc6cac71dc855c0.manifest
File versionNot applicable
File size50,923
Date (UTC)06-Apr-2013
Time (UTC)02:31
PlatformNot applicable

Vlastnosti

ID článku: 2813363 – Posledná kontrola: 17. 5. 2013 – Revízia: 1

Pripomienky