OpenAFS Installation

The easiest method to access ASA website files in the Athena locker is by using OpenAFS. Below are the steps to install the software and configure it on Windows.

Download Kerberos for Windows from the MIT software page and install it.
Restart your computer.
Download the latest OpenAFS for Windows. You only need the first file listed in the Windows 2000/XP/2003 section.
Run the installer.
Result: You are asked to select a language.
Select OK to set English.
Result: The Welcome dialog appears.
Click Next.
Result: The choose components dialog box opens.
Accept the default options by clicking Next.
Result: The Choose Installation Location dialog appears.
Accept the default location and click Next.
Result: The CellServDB Configuration dialog appears.
Accept the default option to Download from web address and select Next.
Result: The Client Cell Name configuration dialog appears.
Enter the AFS Cell Name: athena.mit.edu
Click Next.
Result: The AFS Credentials configuration dialog appears.
Uncheck the Start AFS Credentials at system login check box.
Click Install.
Result: The OpenAFS software will install and then prompt you to reboot.
Click Finish to reboot. (You MUST reboot!!)
After rebooting, open Kerberos by double-clicking on the dog near the clock in the Windows taskbar.

Result: The Leash program opens.
Select AFS Properties from the Options menu.
Result: The AFS Properties window appears.
Select the AFS Enabled option.
Click the AFS Properties button.
Result: The AFS Client Configuration dialog appears.
Select the Drive Letters tab.
Click the Add... button.
Result: The Map Drive Letter dialog appears.
To map your Athena home directory, determine the path to your directory.
From MIT IS&T Article 6845: "Your home directory is located in the overall directory tree as:

/afs/athena.mit.edu/user/first-letter/second-letter/username

Here, username is the name you enter when you login, first-letter is the first letter of your username, and second-letter is the second letter of your username. For instance, if your username were jruser, your home directory would have the following pathname: /afs/athena.mit.edu/user/j/r/jruser"

If either the first or second characters are not alphabetic (j_ruser, for example), you can find out the directory path by typing printenv HOME at your athena% prompt.
Enter:

Your home directory path in the AFS Path
Your username as the submount

Click OK.
Result: Your Athena home directory will now be accessible via a network drive in My Computer.
You are returned to the AFS Client Configuration dialog box.
Select the Add... button again to add the ASA directory. Enter:

\afs\athena.mit.edu\activity\a\asa as the AFS Path
asa as the submount

Click OK.
Result: The ASA Athena directory will now be accessible via a network drive in My Computer.
You are returned to the AFS Client configuration dialog.
Click OK.
Result: The configuration dialog closes. You return to the AFS Properties dialog.
Select OK.
Result: The AFS Properties dialog box closes and you are returned to the Leash program.
To actually access and modify files in the new drives, you must obtain Kerberos tickets. These tickets expire at a set interval, so you will need to renew them periodically and whenever you reboot, to continue to access files using OpenAFS.

Select Get Ticket(s)/Token(s) from the Actions menu.
Result: The Initialize Ticket dialog appears.
Enter:

Kerberos Name (the username you use to check your MIT email)
Kerberos Password (the password you use to check your MIT email)

Click OK.
Result: You now have Kerberos tickets and the dog near the clock should turn green.
Open My Computer. You should now see two network drives that you can browse and save files to just like local hard drives on your computer.
Note: Sometimes it takes a few tries before your computer will actually open up the drives via the network.