|
Size: 3192
Comment:
|
Size: 3489
Comment: Re-wrote page with instructions on how I succesfully configured the OpenAFS on Mac OS X
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 3: | Line 3: |
| == Install OpenAFS == | Connecting to HCoop with AFS on Mac OS X requires setting up the OpenAFS client as well as Kerberos for authentication. On a Mac OS X 10.4 machine, the following steps allowed me to connect to my HCoop account over AFS in a few minutes. |
| Line 5: | Line 5: |
| Obtain the latest openAFS client for Mac OS X. A stable version is available from the following link for 10.5 Leopard. | == Install and Configure OpenAFS == |
| Line 7: | Line 7: |
| http://www.apple.com/downloads/macosx/unix_open_source/openafs.html | Download the latest OpenAFS client (currently 1.4.6) from http://www.openafs.org/macos.html. Install this package and reboot. |
| Line 9: | Line 9: |
| Newer versions are available from http://www.openafs.org/macos.html for 10.4 Tiger and 10.5 Leopard. | The installer will set up the afs configuration files in {{{/var/db/openafs}}} and it will set your machine to start AFS on boot. |
| Line 11: | Line 11: |
| You'll need to reboot after installing the client. ---- About OpenAFS An open source implementation of the Andrew File System (AFS) protocol, including clients, servers and a virtual filesystem kernel driver. It integrates with the bundled Kerberos support in MacOS X to allow for a seamless user experience while accessing files in authenticated sessions. ---- == Configure OpenAFS == The installer will setup the afs files in `/var/db/openafs` and set your machine to start afs on boot. After restarting your system edit `/var/db/openafs/etc/ThisCell`. The file should contain a single line of text: |
After restarting your system edit {{{/var/db/openafs/etc/ThisCell}}} to contain a single line of text: |
| Line 29: | Line 17: |
| The file initially is identical to `ThisCell.sample` so you don't need to make a backup copy before editing. The same holds true for `CellServDB`, it's the same as `CellServDB.master`. | The file initially is identical to {{{ThisCell.sample}}} so you don't need to make a backup copy before editing. The same holds true for {{{CellServDB}}}- it's the same as {{{CellServDB.master}}}. |
| Line 31: | Line 19: |
| Now you'll need to make sure the cells you want to use are listed in the `CellServDB` file. Add the following lines: | Type the following in a terminal: |
| Line 34: | Line 22: |
| >hcoop.net 69.90.123.67 #deleuze.hcoop.net 69.90.123.70 #krunk.hcoop.net |
sudo /Library/StartupItems/OpenAFS/OpenAFS restart |
| Line 39: | Line 25: |
| Now reboot and try the configuration out. Try this from a terminal: |
The command should end with output like: |
| Line 44: | Line 28: |
| user$ sudo /Library/StartupItems/OpenAFS/OpenAFS restart Password: Stopping AFS Unmounting /afs umount: /afs: not currently mounted Shutting down afsd processes /Library/StartupItems/OpenAFS/OpenAFS: line 172: 383 Bus error $AFSD -shutdown 2>&1 >/dev/console Unloading AFS kernel extensions Starting OpenAFS Loading AFS kernel extensions kextload: /var/db/openafs/etc/afs.kext loaded successfully Starting afsd /Library/StartupItems/OpenAFS/OpenAFS: line 172: 391 Bus error $AFSD $OPTIONS /Library/StartupItems/OpenAFS/OpenAFS: line 172: 394 Segmentation fault $CONFIG/afssettings |
afsd: All AFS daemons started. |
| Line 60: | Line 31: |
| Hmmmm. So something went wrong. No clue yet how to fix this. | == Configure Kerberos == |
| Line 62: | Line 33: |
| ''Feel free to help out here, this is as far as we go. If you get something to work add some notes here'' | Install the Kerberos Extras package provided by MIT, available from http://web.mit.edu/macdev/www/osx-kerberos-extras.html. |
| Line 64: | Line 36: |
| = arla for Mac OS X = | Once you've installed this package, run the Kerberos configuration application by clicking on Applications -> Utilities -> Kerberos. Once this application loads, click on the "New" button in the toolbar to create a new ticket. Change the Realm to {{{HCOOP.NET}}} (realms generally seem to be entirely capitalized). Type your HCoop username and password when prompted. You should see a ticket appear in the window which is valid for 10 hours. Now open a terminal window (Applications -> Utilities -> Terminal) and type "aklog". This should initiate your AFS session. To test, browse to the path /afs/hcoop.net/users/, then follow the directories with letters that begin your HCoop username. You should be able to create and edit files on HCoop. == Other tips and tricks == Occasionally, you may have to renew your Kerberos ticket manually or re-initiate your AFS connection. This can be done with two quick commands: type "kinit" (followed by your HCoop pass) and then "aklog" and you should see your AFS volume appear if it wasn't previously available. = Older instructions and misc resources for configuring the AFS client on Mac OS X = Users have tried the following but couldn't get them to work. If the instructions above don't do it for you, maybe something below will. == Other AFS Implementations on Mac OS X (Untested with HCoop) == === arla for Mac OS X === |
OpenAFS for Mac OS X
Connecting to HCoop with AFS on Mac OS X requires setting up the OpenAFS client as well as Kerberos for authentication. On a Mac OS X 10.4 machine, the following steps allowed me to connect to my HCoop account over AFS in a few minutes.
Install and Configure OpenAFS
Download the latest OpenAFS client (currently 1.4.6) from http://www.openafs.org/macos.html. Install this package and reboot.
The installer will set up the afs configuration files in /var/db/openafs and it will set your machine to start AFS on boot.
After restarting your system edit /var/db/openafs/etc/ThisCell to contain a single line of text:
hcoop.net
The file initially is identical to ThisCell.sample so you don't need to make a backup copy before editing. The same holds true for CellServDB- it's the same as CellServDB.master.
Type the following in a terminal:
sudo /Library/StartupItems/OpenAFS/OpenAFS restart
The command should end with output like:
afsd: All AFS daemons started.
Configure Kerberos
Install the Kerberos Extras package provided by MIT, available from http://web.mit.edu/macdev/www/osx-kerberos-extras.html.
Once you've installed this package, run the Kerberos configuration application by clicking on Applications -> Utilities -> Kerberos. Once this application loads, click on the "New" button in the toolbar to create a new ticket. Change the Realm to HCOOP.NET (realms generally seem to be entirely capitalized). Type your HCoop username and password when prompted.
You should see a ticket appear in the window which is valid for 10 hours.
Now open a terminal window (Applications -> Utilities -> Terminal) and type "aklog". This should initiate your AFS session. To test, browse to the path /afs/hcoop.net/users/, then follow the directories with letters that begin your HCoop username. You should be able to create and edit files on HCoop.
Other tips and tricks
Occasionally, you may have to renew your Kerberos ticket manually or re-initiate your AFS connection. This can be done with two quick commands: type "kinit" (followed by your HCoop pass) and then "aklog" and you should see your AFS volume appear if it wasn't previously available.
Older instructions and misc resources for configuring the AFS client on Mac OS X
Users have tried the following but couldn't get them to work. If the instructions above don't do it for you, maybe something below will.
Other AFS Implementations on Mac OS X (Untested with HCoop)
arla for Mac OS X
Arla is a free AFS implementation. The main goal is to make a fully functional client with all capabilities of AFS as formerly sold by Transarc and today available as OpenAFS. Other stuff, such as servers and management tools are being developed, but currently not considered stable.
Obtain latest arla port
Get the latest source code file from the project site and build it yourself:
http://www.stacken.kth.se/project/arla/
Alternatively, go to
http://trac.macports.org/projects/macports/browser/trunk/dports/net/arla/Portfile
or
which have the advantage of being easier to install.
Follow the notes above, and it should "just work" without the "Bus error" or "Segmentation fault".
If you do have success, edit this page and let the rest of us know about it.