RpmClientInstallationWithDKMS.mdwn

   1 This page describes how to use the DKMS OpenAFS package to build
   2 and install an OpenAFS kernel module for your RPM linux based system.
   3 This may be needed if there is not a pre-build kernel module for your
   4 platform and/or kernel version. DMKS is a system to used to build
   5 Linux kernel modules which are not included in the maintained in the
   6 mainline Linux code.
   7
   8
   9 Configure yum for DKMS
  10 ----------------------
  11
  12 yum needs to be configured to install packages from the EPEL (Extra Packages
  13 for Enterprise Linux) repository so you can install dkms.  You may already have
  14 yum configured to pull from EPEL. You can check with yum,
  15
  16      $ yum repolist | grep epel
  17      * epel: mirror.cogentco.com
  18      epel         Extra Packages for Enterprise Linux 5 - x86_64       enabled: 6,330
  19
  20 If you do not have yum configured to use EPEL, then you can add it with an rpm
  21 command, for example,
  22
  23     sudo rpm -Uhv http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm
  24
  25 See <http://fedoraproject.org/wiki/EPEL/FAQ#How_can_I_install_the_packages_from_the_EPEL_software_repository>
  26
  27
  28 Configure yum for OpenAFS
  29 -------------------------
  30
  31 yum needs to be configured to install openafs packages.  An openafs repository
  32 configuration is available on dl.openafs.org:
  33
  34      $ sudo rpm -Uvh http://dl.openafs.org/dl/openafs/<version>/openafs-repository-rhel-<version>-1.noarch.rpm
  35
  36
  37 Kernel Packages
  38 ---------------
  39
  40 You will need to have a kernel-devel package which matches your running kernel
  41 version.  Assuming you want the most recent kernel, you can do this by doing a
  42 yum update of the kernel and kernel-devel packages.
  43
  44     $ sudo yum update kernel kernel-devel
  45
  46 You will need to restart your system if the kernel was updated.  To verify you
  47 have a kernel-devel that matches your kernel version, you can run
  48
  49      $ yum list 'kernel*'
  50
  51
  52 Tools
  53 -----
  54
  55 Install the dkms package and compiler:
  56
  57      $ sudo yum install dkms gcc
  58
  59
  60 OpenAFS Client
  61 --------------
  62
  63 Install the openafs client packages, including the dkms-openafs package to have
  64 the kernel module built for your kernel version.
  65
  66      $ sudo yum install openafs openafs-krb5 dkms-openafs
  67
  68 Startup the client with,
  69
  70      service openafs-client start
  71
  72
  73 At this point you should have a working openafs kernel module.