Windows NFS 4.1 Client Instructions

1. Building

Requirements

• Windows Vista x64, Windows Server 2008 R2 x64, or Windows 7 x64. (Windows XP and previous versions are not supported. 32-bit builds have not been tested.)
• ms-nfs41-client source code:
  > git clone git://citi.umich.edu/projects/ms-nfs41-client.git
• Windows Driver Development Kit (WinDDK 6000 or later)

Instructions

1. Open the WinDDK 'x64 Checked Build Environment' for the target platform.
2. Change directory to ms-nfs41-client and type build. The project should build without errors.

2. Installation

Requirements

• ms-nfs41-client binaries: nfs41_driver.sys, nfs41_np.dll, libtirpc.dll, nfs_install.exe, nfsd.exe, nfs_mount.exe
• ms-nfs41-client configuration files: nfs41rdr.inf, install.bat, uninstall.bat, etc_netconfig

Instructions

1. Copy or extract all ms-nfs41-client binaries and configuration files into a directory that's convenient for testing.
2. Open a WinDDK 'x64 Checked Build Environment' as Administrator in this directory (right click and 'Run as administrator').
3. Create a certificate for test-signing the driver (Creating Test Certificates):
   > makecert /pe /ss PrivateCertStore /n CN=nfs41_test nfs41_test.cer
4. Use the certificate to sign nfs41_driver.sys (Test-Signing a Driver File):
   > signtool sign /v /s PrivateCertStore /n nfs41_test /t http://timestamp.verisign.com/scripts/timestamp.dll nfs41_driver.sys
5. Install the certificate to the 'Trusted Root Certificate Authorities' store:
   > certmgr /add /c nfs41_test.cer /s /r localMachine root
6. Install the driver and update the registry:
   > install.bat
7. Copy the libtirpc configuration:
   > mkdir C:\etc
   > copy etc_netconfig C:\etc\netconfig
8. Allow windows to load test-signed drivers:
   > bcdedit /set testsigning on
9. Reboot.

3. Mounting

Instructions

1. From a Windows command prompt, run nfsd.exe.
2. Open a new Windows command prompt and run nfs_mount.exe to mount a share:
   > nfs_mount.exe Z: nfs.citi.umich.edu:\
3. You can later unmount with:
   > nfs_mount.exe -d Z

4. Connectathon

Requirements

• Cygwin, including packages gcc-core, make, time, tirpc, git
• Connectathon Test Suite
• ms-nfs41-client source code (patches for connectathon are located in ms-nfs41-client\tests)

Instructions

1. Extract nfstests.zip into a directory that's convenient for testing (i.e. cthon04).
2. Open a Cygwin shell, and change directory to cthon04.
3. Create a git repository to track changes:
   > git init
   > git add *
   > git commit -m "files from nfstests.zip"
4. Apply all cthon patches:
   > git am /path/to/ms-nfs41-client/tests/*.patch
5. Build the tests:
   > make
6. Run the test suite on a mounted directory:
   > ./runtests -a -t z:/testdir

5. Known Issues

• AUTH_SYS is not fully implemented, and uses a fake uid=666 and gid=777. Keep this in mind when setting up exports.
• When nfs_mount.exe is run without arguments, it does not properly list mounted drives.
• If nfsd.exe is restarted while a drive is mapped, that drive needs to be remounted before further use.
• Symbolic links are not supported in Cygwin. Connectathon's basic test8 and special test nfsidem have been commented out.
• Does not properly handle renaming a file on top of an existing open file- the existing file is removed on rename, and not preserved until last close. Connectathon's special test op_ren has been commented out.