Building Lustre Code

The procedure on this page describes how to build and configure Lustre code in a development environment. It assumes that you have:

• Checked out Lustre source code from CVS (see Accessing Lustre Code).
• Obtained an unmodified kernel source supported by the version of Lustre you have checked out (supported kernel sources can be found at http://downloads.lustre.org/public/kernels/). Is this the correct link to use?

Configuring and Building Lustre

To configure and build Lustre, follow these steps:

1. Run the autogen script. The autogen script performs a few checks and then bootstraps the build system using the GNU automake and autoconf functions.

$ sh autogen.sh
Checking for a complete tree...
checking for automake-1.7 1.7.8... found 1.7.9
checking for autoconf 2.57... found 2.59
...
running autogen for liblustre...

2. Apply Lustre patches to your unmodified Linux distribution. For instructions, see Applying Lustre Patches to a Kernel.

3. Run configure to set up your system to compile the Lustre code. Configure performs extensive checks of the underlying system and kernel and then produces autoMakefiles and Makefiles.

Note: Replace /path/to/linux with the path to your patched kernel source (for example, /tmp/kernels/linux-2.6.18-128.1.1)

$ ./configure --with-linux=/path/to/linux
checking build system type... i686-redhat-linux-gnu
checking host system type... i686-redhat-linux-gnu
checking target system type... i686-redhat-linux-gnu
...
LLCFLAGS: -g -Wall -fPIC

4. Type 'make' to build Lustre.

$ make
...

5. Install the built Lustre modules in the kernel. We recommend installing them in the modules directory and running the depmod command. Is more detail needed here?