|
Size: 3963
Comment: fix typo and change hard-coded target to uname -m
|
Size: 2750
Comment: converted to 1.6 markup
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 6: | Line 6: |
| [[TableOfContents]] | <<TableOfContents>> |
| Line 8: | Line 8: |
| = Packages to Install and Build = | = Introduction = |
| Line 10: | Line 10: |
| Download the [http://www.openafs.org/release/latest.html OpenAFS source RPM] for your version of Fedora. This will have a filename like openafs-1.4.4-fc6.2.src.rpm. Build this package on your machine with the `rpmbuild` command, such as this one (please alter as necessary): {{{ sudo rpmbuild --rebuild --target=`uname -m` openafs-1.4.4-fc6.2.src.rpm }}} |
There are different sets of RPMS available for OpenAFS. Currently, the easiest to install and maintain across system updates is probably [[http://atrpms.net/|AT RPMS]]. Follow the instructions on the [[http://atrpms.net|atrpms home page]] to set up your Fedora-based machine to pull from the ATRPMS repository, and then follow the instructions below to get AFS working. |
| Line 15: | Line 12: |
| '''Note:''' You will need to have the kernel-headers package installed for this to work. | = Install OpenAFS RPMS with Yum = |
| Line 17: | Line 14: |
| If the build completed successfully, you should see some lines that say "Wrote: " towards the end of the output. To install the new created package, use `rpm`: {{{ rpm -ivh packagename }}} |
Once you've got your machine configured to use AT RPM, install the appropriate openafs kernel module. Check your currently-running kernel with {{{uname -a}}}, and type {{{yum search openafs-kmdl}}} to see the list of openafs kernel modules available. Pick the one that matches your running kernel and install it with yum. An example command for a system running kernel 2.6.23.9-85 would be: |
| Line 22: | Line 16: |
| '''Note:''' should you install a new kernel, you'll have to repeat this part of the process! | {{{yum install openafs-kmdl-2.6.23.9-85.fc8-1.4.6-26.fc8}}} |
| Line 24: | Line 18: |
| Now, install the openafs-1.4.4-fc6.2.i386.rpm, openafs-client-1.4.4-fc6.2.i386.rpm, and openafs-krb5-1.4.4-fc6.2.i386.rpm, or the newest stable packages for your platform. | NB: Don't just type yum install openafs-kmdl here, as it often default to the wrong kernel module. Make sure you get the version that ''exactly'' matches your running kernel. Then, install the rest of the openafs rpm files through yum: {{{yum install openafs openafs-authlibs openafs-doc openafs-client openafs-krb5}}} |
| Line 35: | Line 33: |
| = Rebuilding the OpenAFS Module = You will have to rebuild the source RPM every time your kernel is updated. If you followed the steps above, the source rpm should have been installed in `/usr/src/redhat/SRPMS/`. Use the `rpmbuild` command above to build this. This resulting RPM file will be put in an appropriate directory under `/usr/src/redhat/RPMS` if the build is successful. It will contain the name of the running kernel. Install this RPM, and start the OpenAFS client: {{{ /etc/init.d/openafs-client start }}} If you're lazy you may want to script the process of creating a new OpenAFS module each time you install a new kernel. Here is a script that worked on a Fedora 7 system. It rebuilds the source RPM, installs it, and starts the OpenAFS daemon. The author notes that it hasn't been well tested as it was wrote very quickly, so feel free to make it more robust if desired: {{{ #!/bin/bash # Re-builds the openafs modules for the currently running kernel. # Should work on Fedora systems. # This has not been broadly tested, written Tue Jun 5 11:30:35 EDT 2007 # by Justin S. Leitgeb [leitgebj AT hcoop -- NOSPAM -- net]. OPENAFS_SRPM="/usr/src/redhat/SRPMS/openafs-1.4.4-fc6.2.src.rpm" if [ -a $OPENAFS_SRPM ] ; then echo SRPM $OPENAFS_SRPM exists, starting rebuild. ; rpmbuild --rebuild --target=`uname -m` $OPENAFS_SRPM # Figure out what the filename should be for the new RPM based on # running kernel version, then install it. kernel_name_for_afs=`uname -r | sed 's/-/_/'` # Not a pretty command but it worked for me... we'll see if it does in the future. new_afs_rpm=`find /usr/src/redhat/RPMS/ -type f | grep openafs | grep $kernel_name_for_afs | grep kernel | head -1` rpm -ivh $new_afs_rpm echo Re-starting openafs client... /etc/init.d/openafs-client start fi }}} |
That's it! Since you installed the openafs-kmod package, your machine should automatically pick up new versions of the openafs kernel module when you do yum updates. |
| Line 75: | Line 39: |
| If you get messages saying things like "libafs can't be found" when you try to start the client, you probably installed a version of openafs-kmdl that doesn't match your running kernel. Use yum to remove the openafs RPM packages and try again. |
This is the chapter of the MemberManual that describes how to install the OpenAFS client on RedHat Fedora.
Introduction
There are different sets of RPMS available for OpenAFS. Currently, the easiest to install and maintain across system updates is probably AT RPMS. Follow the instructions on the atrpms home page to set up your Fedora-based machine to pull from the ATRPMS repository, and then follow the instructions below to get AFS working.
Install OpenAFS RPMS with Yum
Once you've got your machine configured to use AT RPM, install the appropriate openafs kernel module. Check your currently-running kernel with uname -a, and type yum search openafs-kmdl to see the list of openafs kernel modules available. Pick the one that matches your running kernel and install it with yum. An example command for a system running kernel 2.6.23.9-85 would be:
yum install openafs-kmdl-2.6.23.9-85.fc8-1.4.6-26.fc8
NB: Don't just type yum install openafs-kmdl here, as it often default to the wrong kernel module. Make sure you get the version that exactly matches your running kernel.
Then, install the rest of the openafs rpm files through yum:
yum install openafs openafs-authlibs openafs-doc openafs-client openafs-krb5
Configuration
Change the home cell in /usr/vice/etc/ThisCell to hcoop.net.
Start the openafs client with sudo /etc/init.d/openafs-client start
- Run kinit and type your password
- Make sure that afsd is running.
- Run "klist" just to make sure that you have a valid token.
- Run aklog - if this works you should be able to see /afs/hcoop.net.
That's it! Since you installed the openafs-kmod package, your machine should automatically pick up new versions of the openafs kernel module when you do yum updates.
Troubleshooting
If you get an error like "aklog: unable to obtain tokens for cell hcoop.net (status: 11862790)" it may mean that your router is blocking SRV requests. If you're running djbdns locally (used by lots of operating systems for embedded devices, such as OpenWrt), make sure that the line filterwin2k is commented out in /etc/dnsmasq.conf, or whatever the configuration file is on your machine.
If you get messages saying things like "libafs can't be found" when you try to start the client, you probably installed a version of openafs-kmdl that doesn't match your running kernel. Use yum to remove the openafs RPM packages and try again.
Read MemberManual/ShellAccess/TroubleshootingKerberos for more.