Setting up an AFS server under Debian

A lot of this will translate to other distributions as well, however I cannot guarantee it will work as it reads.

Before you start

This section is almost definately OS/Distro independant.

Kerberos

AFS needs Kerberos installed. See KerberosNotes for notes this.

Filesystems and Partitions

AFS seems to be fairly filesystem independant, so you can basically use any filesystem you like on the server. It really prefers having a seperate partition for your AFS cell, and some notes I've read hint at it requiring a different fsck for magical reasons, so its probably best to follow this. Put your first partition on /vicepa, and your second on /vicepb, and so on.

Hostname

AFS requires that the hostname of your server resolve via DNS correctly. Make sure this is the case before you get too far down the line, or else you'll hit weird problems that occur for no apparent reason.

Kernel

AFS seems to really dislike linux 2.4.20. I've not tried it on a more recent kernel (not even a pre21 kernel). It does seem to work ok with 2.4.18 however. Make sure you have a kernel that works before continuing, or else things will fail for no good reason!

Installing AFS

Installing the packages:

In debian, install the following: openafs-dbserver openafs-krb5 openafs-client

Your cellname should be your lower-case DNS name, eg element.tla Your DBServer for AFS should be the dns name of the machine you are installing on currently!

Setting up Kerberos

Run the following commands

kadmin.local -e des-cbc-crc:v4

addprinc -randkey afs ktadd -k /tmp/afs.keytab afs quit

kadmin.local

addprinc root

(enter passowrds)

quit

asetkey add 3 /tmp/afs.keytab afs

Partitions

Make sure you have a partition created and mounted at /vicepa. If you cant do this with a real partition, make a loopback one as follows

dd if=/dev/zero of=/var/lib/openafs/vicepa bs=1024k count=32 mke2fs /var/lib/openafs/vicepa mount -oloop /var/lib/openafs /vicepa

Set up the cell

In /etc/openafs, edit the following files and make sure they look something like these

/etc/openafs/ThisCell?

element.tla

/etc/openafs/CellServDb?

element.tla # cell

10.66.1.101 # afs.element.tla

The debian packages, at least, come with a script to do all this for you

afs-newcell

Set up the root volume:

There is also a script to to this

afs-rootvol