UNC AFS Client Installation Guide for Macintosh Systems

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 aklog

      Screen 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.


  • Once this is complete you should be able to open the AFS icon on your desktop.


  • 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.



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.