OpenAFS client Instructions for Mac

Downloading AFS

The OpenAFS client for Mac OS X is available to download from www.openafs.org.

  • Under Downloads select MACOS X. There are Maintenance Release versions of AFS for MACOS X 10.3-10.8; choose the one appropriate for your computer.
  • To check which version of OS X you have, click the Apple icon in the top-left corner of your screen, and select About this Mac.

Installing AFS

  • Once you have downloaded the AFS client, the installation file should mount on your desktop. Double-click OpenAFS.pkg, click Continue, and Agree to the licensing terms.
  • In the Open AFS Client Cell Configuration screen, enter the following

  • Local Cell name: isis.unc.edu
  • Alias for local cell: isis
  • For Select a Description, choose your local hard drive (often Macintosh HD).
  • Click Install, and if prompted, type in your computer’s username and password.
  • Your installation is complete! You should restart your computer now.

Logging in (getting a new token)

To access your H: drive (personal AFS space), you need to get new tokens using the AFS control panel.

  • Click the Apple icon in the top-left corner of your screen, and select System Preferences.
  • In the “Other” section, click on OpenAFS. This is the AFS control panel.
  • On the Tokens tab, click Get new Token. Enter your Onyen and password.

For easier access, be sure to put a check in the “AFS Menu” box. This puts a small padlock icon near the clock, showing your token status and allowing you to refresh your token without opening System Preferences.

Accessing your personal AFS Space

Your personal AFS storage space (your H:drive) is located at:

\\afs\isis.unc.edu\home\o\n\onyen, where “o” and “n” are the first two letters of your ONYEN. For example, if your ONYEN were “stevejobs”, the path would be \\afs\isis.unc.edu\home\s\t\stevejobs.

While OS X does not use drive letters like Windows, we still call your AFS space an H: drive out of convention. Now, we are going to make a shortcut to your H: drive.

  • Click the AFS drive on your desktop, or from the “Devices” list in the Finder.
  • Scroll down to isis.unc.edu, and click home.
  • Click on the first letter of your Onyen, then on the second letter, as explained above.
  • Scroll through the list until you find your Onyen. This folder is your H: drive.

To make it easier to find in the future, drag your Onyen folder to the Places section to the left in the Finder window, or to the Desktop.

Troubleshooting

There are versions of AFS for each version of Mac OS X. If you download the wrong version, the installer will politely let you know.

To use AFS, you must log in (get new tokens), as described above in Logging in (getting a new token). After a period of time, your token will expire, and you will have to get a new token.

If your files do not show up in your H: drive, or if you cannot access them, try getting a new token.

If the padlock icon does not show up in the Menu bar near the clock, make sure there is a check in the “AFS Menu” box in the OpenAFS control panel.