Skip to main content

You may be using a Web browser that does not support standards for accessibility and user interaction. Find out why you should upgrade your browser for a better experience of this and other standards-based sites...

Dartmouth Home  Search  Index

Dartmouth Home | Search | Index

Dartmouth home page
Computing at Dartmouth
Computing > Support >  Library >  Research > UNIX > Files > AFS >

Installing OpenAFS Client on Windows

OpenAFS.org supports Windows 2000 and newer versions with the current releases (as of January 2007). Older versions are still available, with reduced functionality. The maintenance release (currently 1.4.x) provides a more thoroughly tested client with fewer upgrades needed, while the features release provides more frequent updates and access to the latest developments. For Microsoft Windows, the features release is recommended (and required for Vista).

How to Install OpenAFS on Windows

  1. Download OpenAFS for Windows (2000 and newer) and save to disk. The most recent features release is recommended. Choose 32-bit or 64-bit as needed.
  2. Start the installation by double-clicking the OpenAFSforWindows-version.exe file. The installer prompts for input; no subsequent configuration is necessary if these instructions are followed. Perform the installation when logged in as an administrative user.
  3. For the Installation type, select only the OpenAFS client component.
  4. For the location of the CellServDB file, select http download and leave the URL at the default value http://grand.central.org/cellservdb/CellServDB. The file will end up in C:\Program Files\OpenAFS\Client\CellServDB; it can be replaced later, if needed. This gets the latest public cell list, which may be more up to date than the one packaged in the installer.
  5. For the Cell name, enter northstar.dartmouth.edu.
  6. Check Enable DNS.  Do not check Freelance Client or Integrated login.
  7. Check Crypt mode if you wish; it encrypts all the file transfer traffic on the network. The authentication traffic is always encrypted. Crypt mode may have a performance impact.
  8. Leave all the Credentials configuration settings at their default values.
  9. Reboot to start the AFS client service. Any subsequent configuration changes are made through the menus on the client tool (icon is a padlock) which will normally be placed on the Tool bar, or can be found in the main program list.
  10. To get an AFS Client dialog box for authenticating, select Start: Programs: OpenAFS: Client: Authentication. Enter your AFS username and password at the prompts. A shortcut for this may appear directly in the Start menu.
  11. Under the Drive Letters settings, set your AFS home to an unused drive letter. This will allow you to mount your AFS home onto the Windows machine. For example: F: -> \afs\northstar.dartmouth.edu\ufac\AFSusername. System-wide and per-user drive mappings can be defined. Unless UNC paths are used, at least one drive letter mapping must be configured.
  12. Typically, another drive letter is also assigned to the top level of AFS to allow using other parts of our cell or foreign cells.
  13. References to AFS files may also be made using UNC-style paths instead of drive letters (e.g., \\AFS\northstar.dartmouth.edu\ufac\AFSusername).
  14. To change your AFS password, select Start: Run: and enter kpasswd AFSusername. You will be prompted for your current password, then the new one.
  15. An advanced client configuration can be made using the OpenAFS client tool found in the Control Panels. Consult Research Computing for advice on changing those settings from the default values.

Advanced Settings

The AFS client service must be started as administrator; subsequently, non-administrator accounts can use it, but cannot modify some settings. Advanced configuration parameters such as cache size and chunk size can only be modified by administrators. The CellServDB file must be present, but can be empty, as long as the Enable DNS option is selected. Using an empty CellServDB avoids all problems with it becoming out of date, and is adequate if only access to the local cell is needed.

Various OpenAFS command line utilities, as found on UNIX and Mac OS X, are included with the client and the location is automatically added to %PATH. Running a command window will give access to these utilities (kpasswd, fs, vos etc.).

To do a clean uninstall of AFS on Windows, use the uninstall program left in C:\Program Files\OpenAFS\  (logged in as an administrator user).

05/08/08

Computing Services Offices Closed Friday Afternoon, September 5, 2008 for Annual Staff Picnic

Last Updated: 5/9/08