efc3e25adeab6f4843fa87165272cf0f9be0242c
[openafs-wiki.git] / AFSLore / WindowsLoopBackAdapter.mdwn
1 _This topic describes the "why" and "how" of making the Windows [[OpenAFS]] client use the Microsoft Loopback Adapter._
2
3 ## <a name="Why use the Loopback adapter?"></a> Why use the Loopback adapter?
4
5 The AFS Client (both IBM and [[OpenAFS]]) relies on a network protocol called Server Message Block (SMB) to mount AFS drives. This protocol runs on [[NetBIOS]] and is a part of the so-called Common Internet File System (CIFS). Normally, it is used to access Windows shares on remote machines. It is part of what Microsoft calls "File and Print Sharing".
6
7 The AFS Client subverts this protocol for its own uses. Since Windows already knows how to access files on a remote [[NetBIOS]] share, the AFS Client simply pretends it is such a share. Therefore, one might view the Windows AFS Client as a gateway between the AFS world and the [[NetBIOS]] (or "CIFS" or "SMB") world.
8
9 To reiterate, when you access files or use AFS commands (klog, fs, pts, etc) using the Windows AFS Client, you are effectively making your machine talk to itself using the SMB/NetBIOS protocol.
10
11 Since this protocol stack is also used to talk to other computers, it is possible for the AFS Client to receive stray network traffic. Sometimes, this network traffic can interfere with the operation of the AFS Client, causing it to stop working properly or simply crash.
12
13 Fortunately, it is possible to isolate the AFS Client's virtual SMB server from the outside world. This can be done using the "Microsoft Loopback Adapter," as described below.
14
15 ## <a name="How do I use the Loopback adapte"></a> How do I use the Loopback adapter?
16
17 There are two options: run [confloop.msi](http://www.eos.ncsu.edu/wolfcall/loopback), or follow these instructions. I'd recommend the former for system administrators who must do this on lots of machines, and the latter for single users. The instructions were written for Windows XP, but translate fairly directly to Windows 2000.
18
19 ### <a name="Add the Loopback Adapter"></a> Add the Loopback Adapter
20
21 1. Go to Control Panel, and click on "Add Hardware".
22 2. Tell the wizard you've already connected the hardware, and scroll to the bottom of the list to "Add a new hardware device".
23 3. Choose to install the device from a list.
24 4. Choose to install a "Network Adapter", and install the Microsoft Loopback Adapter.
25
26 ### <a name="Configure the Loopback Adapter"></a> Configure the Loopback Adapter
27
28 1. Go to "Network Adapters" in Control Panel, and you should find the connection corresponding to the Microsoft Loopback Adapter.
29 2. Right click on the new connection, and go to properties.
30 3. Double-click on the TCP/IP settings.
31 4. The adapter will be configured by default for DHCP; we want to change this. To configure the Loopback Adapter to use a reserved private network address, type in the following information:
32   - IP Address: 10.0.0.100
33   - Subnet Mask: 255.0.0.0
34   - Default Gateway: **Leave blank**.
35   - DNS servers: **Leave blank**.
36     - If you're on a private network that actually uses 10.\* addresses, change the IP to point to another RFC1918 address space.
37 5. Before you leave the properties for the Loopback Adapter, be sure that "File and Print Sharing for Microsoft Networks" and "Client for Microsoft Networks" are installed and checked. If not, use the Install button to install these services, and check them in the list.
38
39 ### <a name="Turn on Automatic Lana Scan"></a> Turn on Automatic Lana Scan
40
41 1. The automatic Lana scan should find and select the new loopback adapter, and is on by default. However, if you've turned it off, you can turn it back on by going to Start/Settings/Control Panel/AFS Client Configuration, clicking on the "Advanced" tab, going to "Miscellaneous", and checking the box for "Automatic Lana scan." Again, this step is not necessary unless you have changed the settings.
42
43 Thanks to a [patch](http://www.openafs.org/cgi-bin/wdelta/STABLE12-windows-loopback-adapter-support-20021126) included in [[OpenAFS]] 1.2.8+, the next time the AFS service starts, it will automatically find and use the Loopback Adapter, preferring it over other adapters.
44
45 -- [[BenCreech]] - 11 Jul 2003
46
47 -- Modified by [[BenCreech]] - 15 Jul 2003
48
49 `Contributors:`
50
51 - `Scott Williams - the loopback patch`
52 - `Ben Creech - this document`
53 - `Kim Kimball - the last step`