Windows NFS 4.1 Client Instructions

1. Building

Requirements

• 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 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
• a certificate for test signing (http://msdn.microsoft.com/en-us/library/aa906283.aspx)

Instructions

1. Copy or extract all ms-nfs41-client binaries and configuration files into a directory that's convenient for testing.
2. Open an Administrator command prompt in this directory.
3. Test sign nfs41_driver.sys.
4. Install the driver and update the registry:
   > install.bat
5. Copy the libtirpc configuration:
   > mkdir C:\etc
   > copy etc_netconfig C:\etc\netconfig
6. Allow windows to load test-signed drivers:
   > bcdedit /set testsigning on
7. Install the certificate used for test signing to the 'Trusted Root Certificate Authorities' store.
8. Open the Control Panel, navigate to User Accounts, and disable User Account Control (see 5. Known Issues).
9. Reboot.

3. Mounting

Instructions

1. Run nfsd.exe
2. Open a 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, sunrpc, time
• ms-nfs41-client source code (ported tests are located in ms-nfs41-client\tests\cthon04)

Instructions

1. Copy ms-nfs41-client\tests\cthon04 into a directory that's convenient for testing.
2. Open a cygwin shell, and change directory to cthon04.
3. Run the test suite on a mounted directory:
   > ./runtests -a -t z:/testdir

5. Known Issues

• Mounts must be obtained through nfs_mount.exe, and not via 'net use' or 'Map Network Drive'.
• 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. Connectathon's basic test8 will not pass.
• 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.