Troubleshooting Debathena installation

OpenAFS modules

If you got the message

Your AFS client does not seem to be working.

or

aklog: unable to obtain tokens for cell athena.mit.edu (status: 11862788)

when you run renew or aklog, or you get an error like

Starting AFS services:
AFS module /lib/modules/2.6.22-14-generic/fs/openafs.o does not exist.
Not starting AFS.  Please consider building kernel modules using
instructions in /usr/share/doc/openafs-client/README.modules

when your computer boots after a kernel update or when debathena-afs-config is installing, you are probably missing OpenAFS modules for your kernel. To fix this problem, follow the directions below, depending on whether you are running your distribution’s kernel, or a custom kernel. (Missing OpenAFS modules is the most common problem, although AFS might fail to restart for other reasons, like that it is in use, or /var/cache/openafs is not on an ext2 or ext3 filesystem.)

Stock kernel

If you are running the stock kernel of a supported distribution, then you can use our metapackages to ensure that OpenAFS modules get automatically installed for the most recent available kernel.

On Ubuntu, run

sudo aptitude install openafs-modules-generic
sudo /etc/init.d/openafs-client restart

Or on Debian, run

sudo aptitude install openafs-modules-2.6-686
sudo /etc/init.d/openafs-client restart

(You may need to specify a flavor other than generic or 686 if you are using a kernel flavor other than the default.)

Custom kernel

If you built your own kernel, then you will also need to build your own OpenAFS modules before you can use AFS.

Needing new OpenAFS modules is also likely the problem if you get an error message similar to the following when you try to install openafs-modules-`uname -r`.

Couldn't find any package whose name or description matched "openafs-modules-2.6.23"

To build and install OpenAFS modules for your kernel, run:

aptitude install module-assistant;
m-a a-i openafs