## 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 Fedora.

{{{#!wiki important
The bulk of this page reflects Fedora 23. It also contains some potentially helpful, but unverified information, from an earlier version of this page, prefaced with "OLD:"
}}}

<<TableOfContents>>

= Introduction =

There are different sets of RPMS available for OpenAFS.  The easiest to install and maintain across system updates is probably a [[https://copr.fedoraproject.org/coprs/jsbillings/|copr repo]]. Enable it with:

{{{dnf copr enable jsbillings/openafs}}}


= Install OpenAFS RPMS =

Next, install the appropriate openafs kernel module. Check your currently-running kernel with {{{uname -a}}}, then substitute your version into this command:

{{{dnf install kmod-openafs-[PACKAGE.VERSION]-[KERNEL.VERSION]}}}

{{{#!wiki tip
Dnf may default to the wrong kernel module.  Check closely that the version ''exactly'' matches your running kernel.  If not, manually type the entire package and kernel version numbers.
}}}

Then, install the rest of the openafs rpm files:

{{{dnf install openafs openafs-kmdl openafs-authlibs openafs-docs openafs-client krb5-workstation openafs-kmod-docs}}}

= Configuration =

 * Change the home cell in {{{/etc/openafs/ThisCell}}} to hcoop.net.
 * Start the openafs client ''once'' with {{{systemctl start openafs-client.service}}}
  * Enable the openafs client to run on boot with {{{systemctl enable openafs-client.service}}}
 * Run kinit and type your password
 * Make sure that the openafs client is running with {{{systemctl status openafs-client.service}}}
 * 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.

And that's it!

OLD: Your machine should automatically pick up new versions of the openafs kernel module when you do updates. 

= OLD: 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.
----
CategoryMemberManual