Mounting your Nikhef home directory using SSH
for Windows 8

(Updated 27/Sep/2019)

Introduction

This tutorial contains screenshots for the English version of Windows 8. Separate instructions for other versions of Windows are also available:

The instructions for Windows 2000/XP are also still available.
To be able to mount a Windows share over SSH we will need

Administrator access to the local computer, including the ability to elevate privileges. If you don't know what I am talking about then stop reading right here.
PuTTY v0.58+, which is an excellent and free implementation of SSH for Windows. It is assumed that you are familiar with the PuTTY user interface.
One real or virtual network adapter, bound to the Client for Microsoft Networks driver.
Normally you should already have such an adapter, as otherwise you would not be able to mount any Windows shares.
One real or virtual network adapter, NOT bound to the Client for Microsoft Networks driver.

This part of the tutorial is split into the following steps:

As most people do not have a spare real network adapter in their computer, we will add an extra virtual network adapter by installing the Microsoft KM-TEST Loopback Adapter.
After that, the network adapter must be properly configured.
Furthermore, a few Windows system drivers need to be tweaked.
Next, reboot Windows to verify that we've been able to grab port 445 and to see if the smb and lanmanserver drivers are up and running.
If the port was grabbed, but the drivers are not running, then create a task using the Windows Task Scheduler to start the drivers.
Next, we set up a special PuTTY session with the right port-forwarding.
Finally, we start PuTTY and mount our Nikhef home directory.

For those wishing to undo the above steps follow the instructions at the bottom of this tutorial.

Installing the Loopback Adapter

To install the Loopback adapter follow these steps:

Start the Add Hardware Wizard by either going Start->Settings->Control Panel->Add Hardware or by starting a console window with elevated (Administrator) privileges. In the console window type
```
  hdwwiz.exe
```
The Hardware Wizard will come up:
Click Next to continue:

Select Install the hardware that I manually select from a list and click Next.
Now you'll see:

Select the entry Network adapters and click Next.
In the next screen

first select Microsoft from the list of Manufacturers and then select Microsoft KM-TEST Loopback Adapter from the list of Network Adapters. Finally, click Next once more.
Almost finished:

This is your last chance to abort, otherwise, click Next.
After a while you should see:

Click Finish to exit the Hardware Wizard.

You are now ready to configure your newly installed Loopback adapter. Even though Windows might not ask you to, reboot anyways (heey, it's a Microsoft OS ;-)).
From reports I've seen on the Internet a reboot is sometimes required for the loopback adapter to come up properly.

Configuring the Loopback Adapter

Now that your newly installed loopback adapter is up and running we must configure it properly:

Go to the Network Connections Center:
Choose the loopback adapter (usually it is named "Local Area Connection #3") and right-click on it.
Choose Properties, after which a new window will appear

Make sure that
- the entry Client for Microsoft Networks is NOT enabled, i.e. does not have a checkmark in front of it.
- the entry File and Printer sharing for Microsoft Networks is NOT enabled, i.e. does not have a checkmark in front of it.
- the entry Internet Protocol (TCP/IP) is enabled.
Select the entry Internet Protocol (TCP/IP), then click on Properties.
A new window will appear:

Select Use the following IP address and fill in the 'IP address' and 'Subnet mask' as above.
It is not necessary to fill in the 'Default gateway' or a 'DNS server'.
Click on Advanced to make the following window appear:

Deselect Automatic metric and fill in the value of 9999 as the 'Interface metric' as shown above.
Click on the WINS tab:

and select Disable NetBIOS over TCP/IP.
Click on OK.
You are now back in the main 'TCP/IP Properties' screen. Click OK again.
You are now back in the main 'Loopback Properties' screen. Click Close.

Tweaking a few Windows drivers

Now we first need to tweak a Windows system driver to overcome the thing that Microsoft broke. The root cause of the problem is that we need to access the file share using TCP port 445. However, when Windows 8 boots this port is grabbed by the system lanmanserver driver for all interfaces. By delaying the startup of the lanmanserver driver and by installing a portproxy rule we can circumvent this. This section explains how to do this:

Start a console window with elevated (Administrator) privileges.
First, we disable the automatic starting of the lanmanserver driver:
```
  sc config lanmanserver start= demand
```
NOTE the space after the start= !
Make sure the IpHlpSvc driver is running at startup, as otherwise the portproxy rules are not executed:
```
  sc config iphlpsvc start= auto
```
NOTE the space after the start= !
Thanks to Michael Uhlenberg for pointing out this important driver.
Next we add a portproxy rule to reroute TCP port 445 to a port of our choosing. For this tutorial, I choose 44445:
```
  netsh interface portproxy add v4tov4 listenaddress=10.255.255.1 listenport=445
        connectaddress=10.255.255.1 connectport=44445
```
IMPORTANT NOTES:
- The listenaddress is the address of the Loopback adapter configured in the section earlier
- The connectaddress must be identical to the listenaddress
- Using listenaddress=127.0.0.1 does not work. Believe me, I've tried.

If all went well you should see something like
ConfigureConsole

The portproxy rule is persistent, so there should be no need to repeat this step after a reboot.

Reboot and verify

Of course, now that we have disabled the automatic startup of the 'LanmanServer' driver we have to reboot Windows before proceeding.

Verify that the portproxy was applied successfully by checking the open ports on the system. Type in the command console
```
  netstat -an | find ":445 "
```
You should see something like
```
  TCP    10.255.255.1:445    0.0.0.0:0       LISTENING
```
If you see '0.0.0.0:445' instead then the 'portproxy' rule was not applied correctly. Verify that the right 'portproxy' rule was used
```
   netsh interface portproxy show v4tov4
```
and verify that the IpHlpSvc driver is running at Windows startup using
```
  sc query iphlpsvc
```
After Windows comes up and you have logged in, check the status of the 'LanmanServer' driver. Open a command console (no privilege elevation is required) and type
```
  sc query lanmanserver
```
The 'LanmanServer' driver should be in the state Running. If it is not, then follow these steps to create a task using the Task Schedule to start them at system startup.

This also shows the downside of the portproxy method: it is no longer possible to use local shares on the computer while this rule is active.

Configuring PuTTY

Set up a special PuTTY session with the appropriate port-forwarding:

Start PuTTY and create a new session or load your existing session for logging in on login.nikhef.nl. Choose host login2.nikhef.nl and protocol SSH.
Expand the Connection->SSH menu option in the Category tree-list and select Tunnels.
Add a new forwarded port:
- For the Source port, fill in the IP address of your loopback adapter, plus the port 44445 (NOT 445!). The entry field might seem to small for it, but it will work. If you have configured your loopback adapter exactly as in the previous section, then fill in
  10.255.255.1:44445.
- For the Destination, fill in beuk.nikhef.nl:445.
- Click on Add.
You should now see:
In the Category tree-list on the left, scroll back up and choose Session again. Save your session.

Putting it all together

Now that we have configured both our loopback adapter and PuTTY we can put it all together and mount our Nikhef home directory as a Windows share:

Start your newly created Nikhef-PuTTY session and login on login2.nikhef.nl as normal.
Make sure port-forwarding is working properly by checking the PuTTY event log. Select the Window menu of the PuTTY screen (top left) and select Event log. You should see a log similar to:

If not, then check your PuTTY session options first.
Go to Start->Run and type \\10.255.255.1\user\<Your-nikhef-userid>
You will be prompted to authenticate yourself:

For the Username, fill in the domain NIKHEF\ followed by your Nikhef-Windows userid.
For the Password, fill in your Nikhef-Windows password, which might be different from the password you use to log in on login2.nikhef.nl and press OK.
You should now see your Nikhef home directory in Windows Explorer!

Congratulations!

Mapping a network drive

To make life even easier it might be handy to map a network drive to your Nikhef home directory:

Start Windows Explorer and choose Tools->Map Network Drive.
In the next screen, fill in:
- Choose an available drive letter.
- Do NOT click on Browse but type in as the Folder name: \\10.255.255.1\user\<Your-nikhef-userid>
- Enable the checkbox in front of Connect using different credentials.
- Now click on Finish.
In the next screen, fill in your Nikhef-Windows userid:

For the User name, fill in the domain NIKHEF\ followed by your Nikhef-Windows userid.
For the Password, fill in your Nikhef-Windows password, which might be different from the password you use to log in on login.nikhef.nl and press OK.
In the next screen, click on Finish to complete the network drive mapping.
You should now see a new drive letter appear in the Folders tree-list in Windows Explorer. Click on it to verify that you are indeed viewing your Nikhef home directory.

Control+Z! Undo! Undo!

For those wishing to undo the CIFS-over-SSH trick follow these steps:

Start a console window with elevated (Administrator) privileges.
Restore the automatic startup of the smb driver by typing
```
  sc config lanmanserver start= auto
```
NOTE the space after the start= !

Remove the portproxy rule by typing

  netsh interface portproxy delete v4tov4 listenaddress=10.255.255.1 listenport=445

Start a Device Manager by typing
```
  devmgmt.msc
```
Expand the 'Network Adapters', right-click on Loopback adapter and select Uninstall.
If necessary, use the 'Task Scheduler' from the 'Administrative Tasks' menu to delete the task 'Start LanmanServer driver'

Mounting your Nikhef home directory using SSH for Windows 8