reorg: remove the AFSLore subdirectory
[openafs-wiki.git] / 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.