Get Help

Configuring AFS on Mac OS X

Note: (Local) Administrator access will be required for most of the steps in this document

Contents:

Step #1: Download and Install OpenAFSThis is the window that should appear when you mount the dmg

  1. Go to the following website: http://openafs.org/macos.html
  2. Click on the “Maintenance Release” version that will work with your OS version
  3. Go to the download Section and click on link to download
  4. Click on the dmg that has downloaded. The dmg should open a window.
  5. Click and Drag the “Uninstall.command” icon to a safe place on the hard drive

    6. Note: This is used to uninstall OpenAFS

  1. Back in the dmg window, double Click the OpenAFS.pkg icon
  2. Follow the installer guide to install OpenAFS
  3. When prompted for a “local cell name”, enter bu.edu

This page will appear as part of the installation process

 

Step #2: Configure Data Files

  1. Open System Preferences
  2. Click on the OpenAFS Preference pane(Listed under Other)This is how the settings should appear when you first open the preference pane
  3. Click the Shutdown button to stop the AFS service while configuration is completed
  4. Enable the Start AFS at boot checkbox, and click yes if it asks you to create a folder titled “LaunchAgents”
  5. Select the CellServDB Editor tab.
  6. Select all of the servers listed and click the – (minus) button at the bottom of the screen

    7. Note: Removing all of these existing servers may take a little while, please be patient.

  7. Once all servers are removed, click the + (plus) icon to add the BU servers.
  8. Enter the following information:
    9. Afs Cell: bu.edu Comment: Boston University
  9. Add the following Authentication Servers:
    10. 128.197.27.84 kerberos2.bu.edu
    128.197.27.92 kerberos1.bu.edu
    128.197.26.101 kerberos3.bu.edu

    Enter the information as shown.

  10. Click OK, and then Save Cell Configuration
  11. Click Startup to connect to AFS

Note: If this GUI interface does not respond to the Startup button, logout then log back in to your account.


Ensure the checkbox in the red highlighted area is checked

Step #3: Configure Finder View

  1. Switch to the Finder
  2. Open the Finder Preferences
  3. Select the check-box to show Connected Servers on the desktop
  4. A volume named afs should now appear on the desktop

 

 

 

 


Step #4: AFS Verification

If the afs volume does not appear on the desktop, you can check for connectivity through the Terminal:

  1. Open Terminal (located in /Applications/Utilities/)
  2. Type  df -k and hit enter
  3. You should see an AFS volume listed, example:

    4. Filesystem           1024-blocks              Used              Available        Capacity        Mounted on
    /dev/disk0s2       77814832                 13121780     64437052     17%               /
    devfs                   105                           105                0                    100%             /dev
    fdesc                   1                                1                    0                    100%             /dev
    map –hosts         0                                0                    0                    100%             /net
    map auto_home 0                                0                    0                    100%             /home
    AFS                      16000000                  0                    16000000      0%                 /afs

  4. Type  klog -t into the terminal window and hit enter to obtain a AFS token from the Authentication Server.

Note: Obtaining a AFS token can also be accomplished on the Tokens tab of the System Preferences Pane.

 

Click here to download these instructions in pdf form.