OpenAFS and Windows

Known Issues

1. If you need access to Athena AFS and/or to use Athena Kerberos tickets (eg for SAPgui) at the same time that you're accessing CSAIL AFS, we recommend only obtaining Athena Kerberos tickets and configuring AFS as described in the Cross-Cell Howto.
2. My U:\ went away after I upgraded OpenAFS (to > 1.5.66)
   • The AFS client in general and afscreds (the lock icon) in particular no longer map drives. You can re-create the mapped drives in Windows Explorer by going to My Computer, choosing [Tools] -> Map Network Drive, and clicking "Browse" to find for example \\AFS\csail.mit.edu\u\y\you (citation)
3. Where's the OpenAFS control panel? (Vista, Windows 7)
   • The OpenAFS control panel is not yet User Account Control compliant, which means you need to start it as administrator. To do this, first switch your control panel view away from Category, into either "Classic" or "Icon" view. Then double-click "AFS Client Configuration." You may be prompted either to start the AFS control panel As Administrator, or to restart it in compatibility mode; do so.

OpenAFS Installation Instructions

1. Determine whether you're running a 64-bit Windows OS. Right-click My Computer (or Start -> Computer), then choose Properties. If you see "System type: 64-bit Operating System", then you need to install all downloads marked "64-bit Windows OS" when following subsequent instructions. Otherwise, you will use only "32-bit Windows OS" downloads.
2. Is Kerberos for Windows installed (to Start -> Programs -> Kerberos for Windows)? If yes, verify that you can get CSAIL.MIT.EDU Kerberos tickets using your CSAIL Kerberos principal. If no, download the appropriate CSAIL's Kerberos for Windows installer and install it.
3. Download the appropriate version of the OpenAFS installer from CSAIL and start the installation. Click next, then accept the License Agreement.
4. Installation components: leave as default (Typical Install / AFS Client + MS Loopback Adapter). Click Next.
5. Install location: leave as default. Click Next.
6. Choose 'Use packaged CellServDB file, Click Next.
7. At the 'Client Cell Name Configuration Screen,' you must change the cell name to csail.mit.edu . If you use your CSAIL username and password to log onto your machine (for example, if it is part of Active Directory), you can select 'Integrated Logon.' This will log you into AFS automatically when logging onto your windows machine. Otherwise, the defaults are fine. Click Next.
   
8. Choose the default options, then click Install. See below.
   
9. 64-bit Windows OS only: download and install the "32-bit tools for 64-bit Windows OS" from CSAIL

10. Reboot your computer to finish installation.

Post installation

Browsing AFS

At the "Start -> _Search programs and files_" prompt ("Start -> Run" on XP), enter \\AFS\csail.mit.edu to browse the entire csail.mit.edu cell.

Mapping Drive Letters

• Right-click My Computer (may appear as Start -> Computer) and choose "Map Network Drive".
• Drive: Choose the drive letter you wish to use, for example G:
• Folder: Enter the path with backslashes (\), eg \\afs\csail.mit.edu\group\yourgroup
• Reconnect at logon: leave checked YES.
• Click OK.

AFS Performance

After installation, you will may wish to adjust some AFS Client configuration parameters. The default parameters are rather conservative and do not provide adequate performance. If you do not see a padlock icon in the Windows "notification area" (lower right corner of the screen, near the clock), then start the OpenAFS Authentication tool via Start --> All Programs --> OpenAFS --> Client --> Authentication. The padlock should now appear in the notification area. Click on it, and the AFS Client window will pop up.

1. Click Configure AFS Client, which will pop up the AFS Client Configuration window.
2. Select the Advanced tab. Set the Cache Size value to something between 600,000 and 1,000,000. Set the Chunk Size value to 1024.
3. Click the Miscelaneous... button, which will pop up the Miscellaneous Configuration window. Increase the Service Threads value to 5.
4. Dismiss the various AFS Client windows by clicking the OK buttons.
5. Restart the AFS Client if prompted to do so.

Windows ACL Editor

You can change the permissions of AFS folders from Windows. Right-click on the folder you want to modify.

From the window you can create a new ACL or change the properties of an existing one.

Re-installing OpenAFS

The OpenAFS uninstallation tool will usually do what you want, though it doesn't completely remove the OpenAFS client. If you re-install and are still having problems, or just want to completely remove the OpenAFS client, you'll need to:

1. Run the OpenAFS uninstall utility, opting to remove any configuration files.
2. Reboot.
3. Uninstall the Microsoft Loopback adapter. There's more than one way to do this, but going to the Device Manager (right-click 'My Computer',select 'Properties', and then 'Hardware'), right-clicking on the Microsoft Loopback adapter and selecting Uninstall should work.
4. Reboot
5. Remove the c:\Program Files\!OpenAFS directory.
6. Remove the HKLM->SOFTWARE->!OpenAFS registry tree.
7. Reboot

That should remove all traces of the OpenAFS client.

Topic OpenAFSAndWindows . { Edit Attach Backlinks: Web All webs Printable History: r94 < r93 < r92 < r91 < r90 More }