UNC AFS Client Installation Guide for Macintosh Systems

The AFS service is being decomissioned on November 13, 2018. Please go to afs.unc.edu for more information.


The AFS service is being deprecated, if you need to access your files in AFS and you do not already have the OpenAFS client installed on your computer, please use SFTP to retrieve the files. If you only need to download the contents of your AFS home directory, go to https://go.unc.edu/AFS. Please go to https://afs.unc.edu for more information.

Loading the openafs package

The OpenAFS client for Mac OS X 10.11 is available to download from www.auristor.com.

  • When you download the AFS client, the installer’s disk image (DMG) file will mount on your desktop. Double-click AuriStor-client-0.43-ElCapitan.dmg, then double-click the Auristor-Lite.pkg icon in the pop-up:
  • Screen Shot 2015-11-13 at 2.19.43 PM
  • click Continue, and Agree to the licensing terms.
  • In the Auristor Client Cell Configuration screen, enter the following:
  • Screen Shot 2015-11-13 at 2.32.46 PM
  • Local Cell name: isis.unc.edu
  • Alias for local cell: isis
  • Click Continue, and if prompted, type in your computer’s username and password.

AFS will dynamically load after a few seconds and the AFS icon will appear on your desktop.

NOTE: The Finder does not display the AFS volume on the Desktop unless the user has selected ‘Connected servers” in Finder->Preferences->General

Setting Up Kerberos

To setup your machine so that it will access the UNC Kerberos servers, you need to load the krb5.conf package:

  • Go to the UNC Mac openafs download page and click on krb5.conf-unc.dmg. The installer disk image will appear on your desktop.
  • Double-click the desktop disk image. A pop-up window containing the UNC krb5 installation package will appear.
  • Double click krb5.conf-unc.pkg to install the package.

Getting a New Token

To get new tokens use 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 Auristor.
  • On the Tokens tab, click Get new Token.
  • Make sure the following boxes are ticked:
    • AFS Menu
    • Backgrounder
    • Use aklogScreen Shot 2016-03-08 at 3.20.06 PM
  • Enter your Onyen and password.
  • Click Ok

  • On the Tokens screen you should now see the tokens available.
  • Close this screen.AFS-Mac-Tokens
  • Once this is complete you should be able to open the AFS icon on your desktop.AFS-Mac-icon
  • Then you should see the following finder window:
  • Click on the isis.unc.edu folder and navigate to the appropriate AFS space you need to connect to.AFS-Mac-finder


Uninstalling AFS

If you wish to uninstall AFS at any point do the following:

  • Double-click AuriStor-client-0.43-ElCapitan.dmg, then double-click the Extras icon in the pop-up:
  • Screen Shot 2015-11-13 at 2.19.43 PM
  • The Extras folder will open. Double-click the Uninstall-OpenAFS.command icon and then the Uninstall.command icon.
  • Openafs will be removed from your system.