UNC AFS Client Installation Guide for Macintosh Systems

Loading the openafs package

Follow these steps to load the openafs package:

1. Go to the Open AFS Latest Release Page and under the MacOS 10.6 (MacOS 10.5) section, click on the OpenAFS-1.4.11-Snowleopard.dmg (OpenAFS-1.4.6-Leopard.dmg) link.

2. After the package has downloaded, double-click the downloaded OpenAFS-1.4.11-Snowleopard.dmg (OpenAFS-1.4.6-Leopard.dmg) file to unpack the software, then double-click the OpenAFS.pkg icon on your desktop. You will be asked a few inconsequential questions. Installation takes about a minute.

Making local AFS Modifications

Three files need to be modified on the Mac to allow openafs to talk to our local AFS cell.

1. 

%  cd  /private/var/db/openafs/etc

Edit the file named ThisCell: 

%  sudo  vi  ThisCell

Modify the file so that it contains the single line: 

isis.unc.edu

2. In the same directory, edit the file named CellServDB: 

%  sudo  vi  CellServDB

Add the lines below to the beginning of the file: 

>isis.unc.edu # University of North Carolina Project Isis
152.2.1.5  #db0.isis.unc.edu
152.2.1.6  #db1.isis.unc.edu
152.2.1.7  #db2.isis.unc.edu

3. 

%  cd  /private/var/db/openafs/etc/config

Edit the file named afsd.options: 

%  sudo  vi  afsd.options

Modify the file so that it contains the single line: 

-stat  2000  -dcache  800  -daemons  3  -volumes  70  -rootvol  root.afs  -fakestat-all

Link to the AFS executables: 

%  sudo  mkdir  /usr/afsws
%  sudo  ln  -s  /usr/bin  /usr/afsws/bin

Reboot your Mac. When it comes up, the AFS icon should appear on your desktop. You can double-click that to get access to AFS space. Alternatively, you can start up a Terminal window. AFS space appears under /afs.

If AFS does not automatically start on reboot, you can start it manually by invoking the following from a Terminal window:
% sudo /Library/StartupItems/OpenAFS/OpenAFS
The Finder does not display the AFS volume on the Desktop unless the user has selected 'Connected servers" in Finder->Preferences->General

At this point you have access to AFS space, but you don't have permission to your own personal space (most of the folders in your home directory have red minus signs through them). This is because you don't yet have an AFS token. Issue a klog command to obtain a token: 

%  klog  <onyen>

Make sure you can access your AFS filespace through the GUI (the AFS icon on your desktop).

When you log in the first time after a reboot, you won't have a token. You will need to invoke klog to get a token. Tokens are preserved when you log out and back in, however.

ISIS Package Manager Setup

If you wish to use the ipm command to manage software packages in AFS space, your home directory on the Mac must be set to be the same as your home directory in AFS space.

You can determine your AFS home directory by invoking the following command from a Terminal window:

%  grep  ^<your  onyen>:  /afs/isis/common/prop/users  |  awk  -F:  '{print  $6}'

In Mac OS 10.4, open up NetInfo Manager User's pane as above.

1. Click the lock icon in the NetInfo manager window.

2. Enter the name and password of an admin user; click OK .

3. Click on from the NetInfo Manager window.

4. Click on your onyen username.

5. Double-click on the value of home and set it to your AFS home directory.

6. Type Command-S to save your changes.

7. Click Update This Copy.

8. Click the lock icon again to prevent changes.

In Mac OS 10.5, open up

System Preferences > Accounts

1. Click the Accounts icon in the System Preferences window.

2. Click the lock icon in the Accounts manager window.

3. Control-Click on your username under My Account.

4. Click on Advanced Options.

5. Set your AFS home directory.

6. Click OK .

7. Click the lock icon again to prevent changes.

Finally, in a Terminal window create the following symbolic links:

% cd <your AFS home directory>
%  ln  -s  /Users/<your_onyen>/Desktop
%  ln  -s  /Users/<your_onyen>/Documents
%  ln  -s  /Users/<your_onyen>/Downloads
%  ln  -s  /Users/<your_onyen>/Library
%  ln  -s  /Users/<your_onyen>/Music
%  ln  -s  /Users/<your_onyen>/Pictures

Log out and then log back in to get your new environment. Make sure ipm is working correctly, e.g. 

%  ipm  q

should list all the packages you are currently subscribed to.

For more information on the ipm command see the help.unc.edu document: Isis Package Manager

Uninstalling AFS

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

1. Double-click the downloaded OpenAFS-1.4.6-Leopard.dmg (OpenAFS-1.4.6-Tiger.dmg) file.

2. Double-click the Uninstall.command icon in the pop-up window. AFS will be removed from your system.


Top
University of North Carolina - Chapel Hill