Mounting NFS on a Windows Client

Describes how to mount an NFS share on a Windows client, and configure the relevant user and group IDs.

1. Mount the Cluster.

   Windows 10 Enterprise

   Complete the following steps for Windows 10 Enterprise

   1. Open Start > Control Panel > Programs.
   2. Select Turn Windows features on or off.
   3. Select Services for NFS.
   4. Click OK.
   5. Enable write permissions for the anonymous user as the default options only grant read permissions when mounting a UNIX share using the anonymous user.
      To grant write permissions, make a change to the Windows registry by performing the following steps:

      1. Open regedit by typing it in the search box and pressing Enter.
      2. Create a new New DWORD (32-bit) Value inside the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default folder named AnonymousUid and AnonymousGid and assign the UID and GID found on the UNIX directory as shared by the NFS system.
   6. Restart the NFS client or reboot the machine to apply the changes.
   7. Mount the cluster and map it to a drive using the Map Network Drive tool or from the command line.

      mount -o anon usa-node01:/mapr z:

      For more information, see step 2.

   Windows 7 Enterprise

   Complete the following steps for Windows 7 Ultimate or Windows 7 Enterprise

   1. Open Start > Control Panel > Programs.
   2. Select Turn Windows features on or off.
   3. Select Services for NFS.
   4. Click OK.
   5. Mount the cluster and map it to a drive using the Map Network Drive tool or from the command line.

      mount -o nolock usa-node01:/mapr z:

      For more information, see step 2.

   Other Versions of Windows

   Complete the following steps for all other versions of Windows:

   1. Download and install Microsoft Windows Services for Unix (SFU). You only need to install the NFS Client and the User Name Mapping.
   2. Configure the user authentication in SFU to match the authentication used by the cluster (LDAP or operating system users). You can map local Windows users to cluster Linux users, if desired.
   3. Once SFU is installed and configured, mount the cluster and map it to a drive using the Map Network Drive tool or from the command line.

      mount -o nolock usa-node01:/mapr z:

      For more information, see step 2.

2. Map a network drive with the Map Network Drive tool.
   1. Open Start > My Computer.
   2. Select Tools > Map Network Drive.
   3. In the Map Network Drive window, choose an unused drive letter from the Drive drop-down list.
   4. Specify the folder by browsing for the MapR cluster, or by typing the hostname and directory into the text field.
   5. Browse for the MapR cluster or type the name of the folder to map. This name must follow UNC. Alternatively, click Browse… to find the correct folder by browsing available network shares.
   6. Select Reconnect at login to reconnect automatically to the MapR cluster whenever you log into the computer.
   7. Click Finish.
3. Configure the UID and GID for NFS access.

   System that is part of Active Directory Domain

   For a system that is part of the Active Directory Domain, you must instruct the NFS client to access an AD server to get uidNumber and gidNumber.

   1. Ensure that the AD Users schema has auxiliary class posixAccount.
   2. Populate the AD uidNumber and gidNumber fields with the matching uid and gid from Linux.
   3. Configure the NFS client to look up uid and gid in the AD DS store.
   4. Refer to details here: http://technet.microsoft.com/en-us/library/hh509016(v=ws.10).aspx.

   System not using Active Directory

   For a standalone Windows 7 or Vista machine (not using Active Directory), Windows always uses its configured anonymous UID and GID for NFS access, which by default are -2. However, you can configure Windows to use specific values, which results in being able to access NFS using those values.

   The UID and GID values are set in the Windows Registry and are global on the Windows NFS client box. This solution might not work well if your Windows box has multiple users who each need access to NFS with their own permissions, but there is no obvious way to avoid this limitation.

   The values are stored in the registry path HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default. The two DWORD values are AnonymousUid and AnonymousGid. If they do not exist, you must create them.

   Refer to details here: https://docs.microsoft.com/en-us/archive/blogs/msdn/sfu/can-i-set-up-user-name-mapping-in-windows-vista.

4. (Optional) Deactivate the nlockmgr service.
   If the nlockmgr service is active on a Windows machine, attempts to mount a HPE Ezmeral Data Fabric NFS share fail with the following message:

   C:\Users\administrator.Client1>mount -o nolock -u:mapr -p:mapr ClusterNode1:/mapr / g:
   Network Error - 53
   Type 'NET HELPMSG 53' for more information.

   1. Run the rpcinfo command to confirm that the nlockmgr service is active.

      C:\Users\administrator.Client1>rpcinfo -p ClusterNode1
      program version protocol     port
      --------------------------------------------------
      100000       4      tcp      111    portmapper
      100024       1      udp    60588    status
      100007       2      udp      817    ypbind
      100021       1      udp    47016    nlockmgr
      100021       3      udp    47016    nlockmgr
      100021       4      udp    47016    nlockmgr
      100021       1      tcp    34254    nlockmgr
      100021       3      tcp    34254    nlockmgr
      100021       4      tcp    34254    nlockmgr

   2. Check the output for the presence of nlockmgr. To deregister nlockmgr services on the node, use the -d switch in rpcinfo on the HPE Ezmeral Data Fabric node.

      rpcinfo -d 100021 1
      rpcinfo -d 100021 2
      rpcinfo -d 100021 3
      rpcinfo -d 100021 4

   3. Re-check rpcinfo output to verify that no nlockmgr services are registered. The NFS mount completes successfully at this point.

      C:\Users\administrator.Client1>mount -o nolock -u:mapr -p:mapr ClusterNode1:/mapr/ Z:
      Z: is now successfully connected to ClusterNode1:/mapr/
      The command completed successfully.