WARNING: This is the _old_ Lustre wiki, and it is in the process of being retired. The information found here is all likely to be out of date. Please search the new wiki for more up to date information.

Building Lustre Code

From Obsolete Lustre Wiki
Jump to navigationJump to search

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

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 Linux kernel sources. 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 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. To initiate a loopback-based Lustre mount for local testing, run:

lustre/tests/llmount.sh

6. Test your code. Before you submit code, it must pass the acceptance-small acceptance test suite. For more details see Testing Lustre Code.

6. To clean up the loopback mount (reverse the actions of the llmount.sh script), run lustre/tests/llmountcleanup.sh . Please see Running_Lustre_Tests_For_Developers for additional information. Testing Lustre Code