<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>MemberManual/TransferringFiles/OpenAFS/Fedora</title><revhistory><revision><revnumber>16</revnumber><date>2019-01-14 19:38:53</date><authorinitials>StephenMichel</authorinitials><revremark>Phrasing tweaks</revremark></revision><revision><revnumber>15</revnumber><date>2019-01-14 19:37:53</date><authorinitials>StephenMichel</authorinitials><revremark>Fedora openafs page formatting</revremark></revision><revision><revnumber>14</revnumber><date>2019-01-14 18:50:27</date><authorinitials>StephenMichel</authorinitials><revremark>Remove vestigal plural</revremark></revision><revision><revnumber>13</revnumber><date>2019-01-14 18:49:18</date><authorinitials>StephenMichel</authorinitials><revremark>Update fedora openafs package names / repos</revremark></revision><revision><revnumber>12</revnumber><date>2016-01-11 10:27:29</date><authorinitials>StephenMichel</authorinitials><revremark>Brought page up to date, remove CategoryOutdated</revremark></revision><revision><revnumber>11</revnumber><date>2013-01-14 09:04:02</date><authorinitials>ClintonEbadi</authorinitials><revremark>needs work</revremark></revision><revision><revnumber>10</revnumber><date>2009-09-09 20:08:31</date><authorinitials>ClintonEbadi</authorinitials><revremark>Revert to revision 8.</revremark></revision><revision><revnumber>9</revnumber><date>2009-09-09 18:20:33</date><authorinitials>93.174.94.59</authorinitials><revremark>-76</revremark></revision><revision><revnumber>8</revnumber><date>2008-07-07 04:27:53</date><authorinitials>localhost</authorinitials><revremark>converted to 1.6 markup</revremark></revision><revision><revnumber>7</revnumber><date>2007-12-30 07:56:35</date><authorinitials>JustinLeitgeb</authorinitials><revremark>updated directions with easier method of maintaining yum on fedora machines</revremark></revision><revision><revnumber>6</revnumber><date>2007-11-30 13:51:36</date><authorinitials>JustinLeitgeb</authorinitials><revremark>fix typo and change hard-coded target to uname -m</revremark></revision><revision><revnumber>5</revnumber><date>2007-11-30 13:49:22</date><authorinitials>JustinLeitgeb</authorinitials><revremark>Change rpmbuild command to be more platform independent.</revremark></revision><revision><revnumber>4</revnumber><date>2007-11-12 18:14:01</date><authorinitials>MichaelOlson</authorinitials><revremark>Fix troubleshooting kerb link</revremark></revision><revision><revnumber>3</revnumber><date>2007-11-12 04:30:01</date><authorinitials>MichaelOlson</authorinitials><revremark>Shorten</revremark></revision><revision><revnumber>2</revnumber><date>2007-11-06 05:51:20</date><authorinitials>RyanMikulovsky</authorinitials><revremark>more clean-ups</revremark></revision><revision><revnumber>1</revnumber><date>2007-11-06 05:46:40</date><authorinitials>RyanMikulovsky</authorinitials><revremark>transfer from AfsFedoraClientConfiguration, clean up.</revremark></revision></revhistory></articleinfo><para>This is the chapter of the <ulink url="https://wiki.hcoop.net/MemberManual/TransferringFiles/OpenAFS/Fedora/MemberManual#">MemberManual</ulink> that describes how to install the OpenAFS client on Fedora. </para><important><para>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 &quot;OLD:&quot; </para></important><section><title>Introduction</title><para>There are different sets of RPMS available for OpenAFS.  The easiest to install and maintain across system updates is probably a <ulink url="https://copr.fedoraproject.org/coprs/jsbillings/">copr repo</ulink>. Enable it with: </para><para><code>dnf copr enable jsbillings/openafs</code> </para></section><section><title>Install OpenAFS RPMS</title><para>Next, install the appropriate openafs kernel module. Check your currently-running kernel with <code>uname -a</code>, then substitute your version into this command: </para><para><code>dnf install kmod-openafs-[PACKAGE.VERSION]-[KERNEL.VERSION]</code> </para><tip><para>Dnf may default to the wrong kernel module.  Check closely that the version <emphasis>exactly</emphasis> matches your running kernel.  If not, manually type the entire package and kernel version numbers. </para></tip><para>Then, install the rest of the openafs rpm files: </para><para><code>dnf install openafs openafs-kmdl openafs-authlibs openafs-docs openafs-client krb5-workstation openafs-kmod-docs</code> </para></section><section><title>Configuration</title><itemizedlist><listitem><para>Change the home cell in <code>/etc/openafs/ThisCell</code> to hcoop.net. </para></listitem><listitem><para>Start the openafs client <emphasis>once</emphasis> with <code>systemctl start openafs-client.service</code> </para><itemizedlist><listitem><para>Enable the openafs client to run on boot with <code>systemctl enable openafs-client.service</code> </para></listitem></itemizedlist></listitem><listitem><para>Run kinit and type your password </para></listitem><listitem><para>Make sure that the openafs client is running with <code>systemctl status openafs-client.service</code> </para></listitem><listitem><para>Run &quot;klist&quot; just to make sure that you have a valid token. </para></listitem><listitem><para>Run aklog - if this works you should be able to see /afs/hcoop.net. </para></listitem></itemizedlist><para>And that's it! </para><para>OLD: Your machine should automatically pick up new versions of the openafs kernel module when you do updates.  </para></section><section><title>OLD: Troubleshooting</title><para>If you get an error like &quot;aklog: unable to obtain tokens for cell hcoop.net (status: 11862790)&quot; it may mean that your router is blocking SRV requests.  If you're running <code>djbdns</code> locally (used by lots of operating systems for embedded devices, such as <ulink url="https://wiki.hcoop.net/MemberManual/TransferringFiles/OpenAFS/Fedora/OpenWrt#">OpenWrt</ulink>), make sure that the line <code>filterwin2k</code> is commented out in /etc/dnsmasq.conf, or whatever the configuration file is on your machine. </para><para>If you get messages saying things like &quot;libafs can't be found&quot; 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. </para><para>Read <ulink url="https://wiki.hcoop.net/MemberManual/TransferringFiles/OpenAFS/Fedora/MemberManual/ShellAccess/TroubleshootingKerberos#">MemberManual/ShellAccess/TroubleshootingKerberos</ulink> for more. </para><!--rule (<hr>) is not applicable to DocBook--><para> <ulink url="https://wiki.hcoop.net/MemberManual/TransferringFiles/OpenAFS/Fedora/CategoryMemberManual#">CategoryMemberManual</ulink> </para></section></article>