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

    AFS-Mac-UserPass
  • 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.