Information, Technology & Consulting

OpenAFS Client for Windows

Step-by-Step

The OpenAFS client for Windows works on all versions of Windows from XP through Windows 8.x. On this page we provide a download link and instructions for the most recent version that Research Computing has tested. openafs.org/windows.html has the official documentation and possibly newer versions of the software.

  • Installing the client
  • Basic usage
  • Uninstalling the client

Installing the OpenAFS Client for Windows

  1. Download the OpenAFS installer.
  2. Double click the installer that you downloaded in step 1. This begins the installation process. If asked whether or not you want to run the file, click Run.

  3. Click Next on the Welcome screen.

  4. Click I accept the terms... and then click Next on the screen with the license terms.

  5. IMPORTANT: Click Custom when asked to "Choose Setup Type". Below is a screenshot of what you'll see after clicking Custom.
    • Scroll about halfway down to Authentication for AFS and click to change to Will be installed on local hard drive.
    • Just beneath that also click Client configuration tool to change to Will be installed on local hard drive.
    • Click Next.



  6. IMPORTANT: You need to enter a default cell on the "Configure AFS Client" screen. Type northstar.dartmouth.edu in the text box. The rest of the options on this screen should be left at their defaults. It is particularly important that you do not enable "Integrated login". Click Next.




  7. Click Next. This is the "Options for AFS Credentials" screen and we recommend leaving the default settings.

  8. Click Install. You may be asked if you want to allow the software to be installed. If so, click Yes.

  9. Click Finish.

  10. You will be prompted to reboot your computer. Do this at your convenience but the AFS client will not work until you have.

Basic Usage

  • Authenticating: To access your files in AFS, you first need to authenticate yourself. This is called getting a token. The yellow padlock icon AFS padlock icon is the authentication tool and should be in the System Tray on your desktop. Click it to bring up a window where you can enter your AFS username and password. Note this window will also pop up automatically when you first boot your computer.
  • Token Expiration: AFS tokens last for 25 hours. After that time you will need to obtain a new one using the same authentication tool. You can also renew a token at any time which resets the 25 hour clock.
  • UNC Paths: You use UNC paths to access files in AFS (e.g. type a UNC path into the address bar in Windows Explorer). The most common example of a UNC path is
    \\afs\northstar.dartmouth.edu\users\u\username
    'username' is of course your AFS username. The 'u' in \u\ is the first letter of your AFS username.
  • Creating a Mapped Drive: Not all software recognizes UNC paths.  In these cases you need to assign a drive letter to the UNC path. This is called creating a mapped network drive and creates a per-user drive mapping which only exists when you are logged in.
    1. Bring up an Explorer window by holding down the Windows key Windows key icon and pressing E.
    2. [Windows 8 only] From the File - Computer - View tabs at the top of the screen select Computer.
    3. Click Map Network Drive [Windows 8 gives a drop-down list where you select Map Network Drive again].
    4. Choose a drive letter and enter the UNC path to a location in AFS.
    5. Click Finish.

Uninstalling the OpenAFS Client for Windows

To uninstall the OpenAFS client, use the "Uninstall OpenAFS" shortcut that the installer placed in your Start Menu (Apps Screen in Windows 8). Or, you can run it directly like this:

  1. Bring up a Run window by holding down the Windows key Windows key icon and then pressing the R key.
  2. Type C:\Program Files\OpenAFS\uninstall.exe and hit Enter.
  3. Follow the prompts.
Topic: 
Research Computing
Subtopic: 
Research Storage
Last updated: 
Monday, August 15, 2016

If you have questions or need further information, contact your department's IT support office, or contact the IT Service Desk via email at [email protected], via phone at 603-646-2999 or walk in to see them in Baker/Berry 178J.

Close
Information, Technology & Consulting