OpenAFS on RedHat Linux

Note: The following instructions are provided by dcm, not tig, so contact him with questions or comments.

Fedora Core 3 Instructions

For Fedora Core 3 users, I have created some packages to automate the above process. These packages have been built with the necessary CSAIL configuration so that no extra configuration work is required. For a working client machine, you'll first need to generate a binary package containing the kernel module for your currently running kernel. To do this, download openafs-1.4.0-0.rc2.2csail.src.rpm, and as root run:

rpmbuild --rebuild openafs-1.4.0-0.rc2.2csail.src.rpm --with kernelonly

This command requires some basic prerequisites such as the rpm-build package. It will automatically find your current kernel headers in the /lib/modules directory, build the OpenAFS? kernel module, and package it into an RPM. After the build completes successfully, it will create a new file /usr/src/redhat/RPMS/i386/openafs-kernel-1.4.0-0.rc2.2csail_KERNELVERSION.i386.rpm, where KERNELVERSION is the name of your currently running kernel. If you ever upgrade the kernel, just repeat this process to generate a new package for the kernel.

Next, download openafs-1.4.0-0.rc2.2csail.i386.rpm and openafs-client-1.4.0-0.rc2.2csail.i386.rpm and install them together with the kernel module, by running the following as root:

rpm -i openafs-1.4.0-0.rc2.2csail.i386.rpm openafs-client-1.4.0-0.rc2.2csail.i386.rpm openafs-kernel-1.4.0-0.rc2.2csail_KERNELVERSION.i386.rpm

Assuming that command runs successfully, you now have a working OpenAFS? installation! It will be started automatically on the next reboot. If for some reason you do not want OpenAFS? to start automatically at boot time, run the command chkconfig afs off. To start the daemon without rebooting run:

/etc/init.d/afs start

Once AFS is running, you should see the list of cells in your /afs directory. The CSAIL cell is /afs/csail.mit.edu. To get a token to access your files, first get a kerberos token by running kinit, and then an AFS token by running aklog.

Fedora Core 5 Instructions

For Fedora Core 5 users, openafs provides suitable RPMs. A pre-release version of openafs is necessary for compatability with FC5's 2.6.16 kernel. As of this writing (April 10, 2006), openafs 1.4.1-rc10 is the latest version and is linked in the urls below, however, you should check for newer versions by exploring the directory structure of the linked server.

For a working client machine, you'll first need to generate a binary package containing the kernel module for your currently running kernel. If you have never built RPMs on your machine before, first install the fedora-rpmdevtools package and the kernel-devel or kernel-smp-devel package. Run 'fedora-buildrpmtree' to set up your (non-root) home directory for building RPMs. Next, download openafs-1.4.1rc10-fc5.1.src.rpm, and run (not as root):

rpmbuild --rebuild --target=i686 openafs-1.4.1rc10-fc5.1.src.rpm

This will automatically find your current kernel headers in the /lib/modules directory, build the OpenAFS? kernel module, and package it into an RPM. After the build completes successfully, it will create a new file ~/rpmbuild/RPMS/i686/openafs-kernel-1.4.1rc10-KERNELVERSION.i686.rpm or openafs-kernel-smp-1.4.1rc10-KERNELVERSION.i686.rpm, where KERNELVERSION is the name of your currently running kernel. If you ever upgrade the kernel, just repeat this process to generate a new package for the kernel.

Next, download openafs-1.4.1rc10-fc5.1.i386.rpm, openafs-client-1.4.1rc10-fc5.1.i386.rpm, and openafs-krb5-1.4.1rc10-fc5.1.i386.rpm and install them together with the kernel module, by running the following as root:

rpm -i openafs-kernel-1.4.1rc10-KERNELVERSION.i686.rpm openafs-1.4.1rc10-fc5.1.i386.rpm openafs-client-1.4.1rc10-fc5.1.i386.rpm openafs-krb5-1.4.1rc10-fc5.1.i386.rpm

Assuming that command runs successfully, you should now make two configuration file changes so the CSAIL cell will work. First, change the contents of /usr/vice/etc/ThisCell to "csail.mit.edu". Next, open /etc/sysconfig/openafs, and change the line that starts with AFSD_ARGS to:

AFSD_ARGS="-dynroot -fakestat -afsdb"

You now have a working AFS installation! It will be started automatically on the next reboot. If for some reason you do not want OpenAFS? to start automatically at boot time, run the command chkconfig openafs-client off. To start the daemon without rebooting run:

/etc/init.d/openafs-client start

Once AFS is running, you should see the list of cells in your /afs directory. The CSAIL cell is /afs/csail.mit.edu. To get a token to access your files, first get a kerberos token by running kinit, and then an AFS token by running aklog.

-- Main.dcm - 10 Apr 2006
Topic attachments
I Attachment Action Size Date Who Comment
openafs-1.4.0-0.rc2.2csail.i386.rpmrpm openafs-1.4.0-0.rc2.2csail.i386.rpm manage 2119.8 K 13 Nov 2006 - 18:44 UnknownUser FC3 Binary RPM required for all AFS installations
openafs-1.4.0-0.rc2.2csail.src.rpmrpm openafs-1.4.0-0.rc2.2csail.src.rpm manage 10746.2 K 13 Nov 2006 - 18:44 UnknownUser FC3 Source RPM
openafs-client-1.4.0-0.rc2.2csail.i386.rpmrpm openafs-client-1.4.0-0.rc2.2csail.i386.rpm manage 193.0 K 13 Nov 2006 - 18:44 UnknownUser FC3 Binary RPM for AFS client
Topic revision: 16 Nov 2009, ArthurProkosch
 

MIT Computer Science and Artificial Intelligence Laboratory

 

  • About CSAIL
  • Research
  • News + Events
  • Resources
  • People

This site is powered by Foswiki MIT: Massachusetts Institute of Technology