## page was renamed from MemberManual/TransferringFiles/OpenAFS/FedoraClient #pragma section-numbers off This is the chapter of the MemberManual that describes how to install the OpenAFS client on RedHat Fedora. [[TableOfContents]] = Introduction = 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. = 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.