|
Size: 2795
Comment: needs work
|
Size: 2920
Comment: Brought page up to date, remove CategoryOutdated
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 4: | Line 4: |
| This is the chapter of the MemberManual that describes how to install the OpenAFS client on RedHat Fedora. | This is the chapter of the MemberManual that describes how to install the OpenAFS client on Fedora. NB: When this page was updated to reflect Fedora 23, some potentially helpful but unverified information from the out-of-date page was left in the page. This information will be prefaced with "OLD:" |
| Line 10: | Line 12: |
| 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. | There are different sets of RPMS available for OpenAFS. Currently, the easiest to install and maintain across system updates is probably a [[https://copr.fedoraproject.org/coprs/jsbillings/|copr]] repo. You must enable two repositories: |
| Line 12: | Line 14: |
| = Install OpenAFS RPMS with Yum = | {{{dnf copr enable jsbillings/openafs}}} |
| Line 14: | Line 16: |
| 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: | {{{dnf copr enable jsbillings/openafs-kmod}}} |
| Line 16: | Line 18: |
| {{{yum install openafs-kmdl-2.6.23.9-85.fc8-1.4.6-26.fc8}}} | = Install OpenAFS RPMS with Dnf = |
| Line 18: | Line 20: |
| 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. | Once you've enabled both repositories on your machine, install the appropriate openafs kernel module. Check your currently-running kernel with {{{uname -a}}}, then use the template command below. |
| Line 20: | Line 22: |
| Then, install the rest of the openafs rpm files through yum: | {{{dnf install kmod-openafs-[PACKAGE.VERSION]-[KERNEL.VERSION]}}} |
| Line 22: | Line 24: |
| {{{yum install openafs openafs-authlibs openafs-doc openafs-client openafs-krb5}}} | NB: 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 through dnf: {{{dnf install openafs openafs-kmdl openafs-authlibs openafs-docs openafs-client openafs-krb5 openafs-kmod-docs}}} |
| Line 26: | Line 32: |
| * Change the home cell in {{{/usr/vice/etc/ThisCell}}} to hcoop.net. * Start the openafs client with {{{sudo /etc/init.d/openafs-client start}}} |
* 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}}} |
| Line 29: | Line 36: |
| * Make sure that afsd is running. | * Make sure that the openafs client is running with {{{systemctl status openafs-client.service}}} |
| Line 33: | Line 40: |
| 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. | That's it! OLD: Your machine should automatically pick up new versions of the openafs kernel module when you do updates. |
| Line 35: | Line 42: |
| = Troubleshooting = | = OLD: Troubleshooting = |
| Line 43: | Line 50: |
| CategoryMemberManual CategoryOutdated | CategoryMemberManual |
This is the chapter of the MemberManual that describes how to install the OpenAFS client on Fedora.
NB: When this page was updated to reflect Fedora 23, some potentially helpful but unverified information from the out-of-date page was left in the page. This information will be prefaced with "OLD:"
Introduction
There are different sets of RPMS available for OpenAFS. Currently, the easiest to install and maintain across system updates is probably a copr repo. You must enable two repositories:
dnf copr enable jsbillings/openafs
dnf copr enable jsbillings/openafs-kmod
Install OpenAFS RPMS with Dnf
Once you've enabled both repositories on your machine, install the appropriate openafs kernel module. Check your currently-running kernel with uname -a, then use the template command below.
dnf install kmod-openafs-[PACKAGE.VERSION]-[KERNEL.VERSION]
NB: 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 through dnf:
dnf install openafs openafs-kmdl openafs-authlibs openafs-docs openafs-client openafs-krb5 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.
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.