Getting to run openafs client on Debian 3.0

Your aim

You want to install OpenAFS on a Debian 3.0 (Woody) Linux System and configure the client, i.e. you want to access an AFS cell.

This article contains a step-by-step instruction, how I managed to get to run that on my system. I am using:

How to do it

First you need to install the software for the AFS client. For AFS you need some kernel modules which you have to compile yourself (at least for kernel version 2.4.18).:

# apt-get install openafs-client openafs-modules-source

When installing the openafs-client package you will be asked some questions. Enter the following values:

Now you have to compile the AFS kernel modules. Be sure to have installed the kernel sources. If not, you can easily do so now:

# apt-get install kernel-source-2.4.18

Now change to /usr/src and unpack the kernel source and the AFS module sources:

# cd /usr/src
# tar xjf kernel-source-2.4.18.tar.bz2
# tar xzf openafs.tar.gz

Change to the kernel source directory and copy the kernel configuration from /boot to file file .config. You need to find the config file matching you kernel version.

# uname -r
2.4.18-k7
# cp /boot/config-2.4.18-k7 .config

Now you can build the afs modules with the following two commands (still being in the main directory of the kernel sources. To the option --append-to-version you have to add you architecture subversion, such as k7 for my Athlon 700. Check you uname -r:

# make-kpkg clean
# make-kpkg configure --append-to-version -k7
# make-kpkg modules_image --append-to-version -k7

This takes a couple of minutes and produces lot's of output. The last line should be:

Module /usr/src/modules/openafs processed fine

If you step up into /usr/src you will find a freshly built .deb Package with you afs modules:

# cd ..
# ls *.deb
openafs-modules-2.4.18-k7_1.2.3final2-6+10.00.Custom_i386.deb

Install this with dpkg -i:

# dpkg -i openafs-modules-2.4.18-k7_1.2.3final2-6+10.00.Custom_i386.deb

If all went well you should now be able to start the afs client daemon by calling its start script:

# /etc/init.d/openafs-client start
Warning: loading /lib/modules/2.4.18-k7/fs/openafs.o will taint the kernel: no license
Warning: loading /lib/modules/2.4.18-k7/fs/openafs.o will taint the kernel: forced load
Starting AFS services: Starting AFS cache scan...found 0 non-empty cache files (0%).
afsd: All AFS daemons started.
 afsd.

Now your AFS client should be running. If there are no other problems (e.g. firewalls in your way), you should be able to access one of the globally accessable public AFS servers, e.g. grand.central.org:

# ls /afs/grand.central.org
. .. archive contrib doc project service software user

Keywords: openafs afs debian woody debian30   Author: Mathias Kettner

Tauschzone MK