AFS for OS X Tiger

From WolfTech
Jump to: navigation, search

This page will assist you in installing OpenAFS 1.4.1 and configuring it to allow you access to your AFS files on Mac OS X 10.4. This process requires you to use Terminal and make changes as root, and also to use NetInfo Manager to make changes to users and groups. You will need administrator access to make these changes. Do NOT attempt this process if you are not comfortable with changing file permissions or system settings.

If you need assistance with installing and configuring OpenAFS, please email us at ecehelp@ncsu.edu.

Important Notes

  • In order to AFS to work properly, the short name of your OS X user account must be identical to your unity username. It is not possible to change the short name of your account if it is not correct.
  • You must have administrator access to the machine to install OpenAFS and make the changes in Terminal and NetInfo Manager.

Install OpenAFS

  • Download OpenAFS 1.4.1 from here. Start the installer and install the program to your machine.
  • Restart your machine after the installation.

Configure OpenAFS

  • Download the following two files to your desktop (files created and provided by Jason Corley):
openafs.sh - A configuration script for OpenAFS
kerberos_init.sh - The authentication script
  • Open Terminal and use the command "sudo su -" and your admin password to change to root.
  • As root, run openafs.sh. If you cannot run it, open openafs.sh in TextEdit and copy/paste the contents into the Terminal window.
  • Next, perform the following two commands in Terminal:
cp /Users/<your username>/Desktop/kerberos_init.sh /bin
chmod 755 /bin/kerberos_init.sh
  • Close Terminal

Edit User Settings

  • You will need to know your numeric unityID to complete this part. To find your numeric ID, go to User Lookup and enter in your username, then look under "Hesiod Database Information". You can also use the command "hes username" from a unix machine.
  • Your numeric ID is the number that follows your username.
  • Open Applications -> Utilities -> NetInfo Manager
  • Click on Groups, then find the entry for your username
  • Change name to ncsu
  • Change gid to 108
  • Press Command+S or goto Domain -> Save Changes to save.
  • Click on Users, and again find the entry for your username
  • Change uid to match your numericID
  • Change gid to 108
  • Press Command+S or goto Domain -> Save Changes to save.
  • Log out and log back in
  • Open Terminal and authenticate to root. Run the following command as root
chown -R numericID:108 /Users/<your username>
  • Close Terminal and log out and log back in

Authenticating to AFS

  • Open Terminal and run the following command
/bin/kerberos_init.sh
  • You will be prompted for your unity password. After authenticating, you can now access your AFS files from either Terminal (cd /afs/<path to your folder>/) or from the AFS icon on your desktop.