http://wiki.lustre.org/index.php?action=history&feed=atom&title=Building_Lustre_CodeBuilding Lustre Code - Revision history2026-10-02T07:37:00ZRevision history for this page on the wikiMediaWiki 1.39.7http://wiki.lustre.org/index.php?title=Building_Lustre_Code&diff=1773&oldid=prevKenRawlings: page creation as part of wiki migration effort2016-06-15T14:27:39Z<p>page creation as part of wiki migration effort</p>
<p><b>New page</b></p><div>{| class='wikitable'<br />
|- <br />
!Note: This page originated on the old Lustre wiki. It was identified as likely having value and was migrated to the new wiki. It is in the process of being reviewed/updated and may currently have content that is out of date.<br />
|}<br />
<br />
<small>''(Updated: Dec 2009)''</small><br />
<br />
The procedure on this page describes how to build and configure Lustre™ code in a development environment. It assumes that you have:<br />
* Checked out Lustre source code from Git (see [[Accessing Lustre Code]]).<br />
* 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/ http://downloads.lustre.org/public/kernels/]).<br />
<br />
'''''Note:''''' For how to install Lustre from source for a non-supported system configuration, see [[Building and Installing Lustre from Source Code]].<br />
<br />
== Configuring and Building Lustre ==<br />
To configure and build Lustre, follow these steps:<br />
<br />
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.<br />
<pre><br />
$ sh autogen.sh<br />
Checking for a complete tree...<br />
checking for automake-1.7 1.7.8... found 1.7.9<br />
checking for autoconf 2.57... found 2.59<br />
...<br />
running autogen for liblustre...<br />
</pre><br />
2. ''Apply Lustre patches to your Linux kernel sources.'' For instructions, see [[Applying Lustre Patches to a Kernel]].<br />
<br />
3. ''Build a new kernel.''<br />
<br />
4. ''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''. <br />
<br />
'''''Note:''''' Replace ''/path/to/linux'' with the path to your patched kernel source (for example, ''/tmp/kernels/linux-2.6.18-128.1.1'')<br />
<pre><br />
$ ./configure --with-linux=/path/to/linux<br />
checking build system type... i686-redhat-linux-gnu<br />
checking host system type... i686-redhat-linux-gnu<br />
checking target system type... i686-redhat-linux-gnu<br />
...<br />
LLCFLAGS: -g -Wall -fPIC<br />
<br />
Type 'make' to build Lustre.<br />
</pre><br />
<br />
5. ''Type ''make'' to build Lustre.''<br />
<pre><br />
$ make<br />
...<br />
</pre><br />
<br />
==== Building and Testing Your Code ====<br />
Before you submit code for possible inclusion in Lustre, it must pass the ''acceptance-small'' acceptance test suite. For more details about the Lustre testing framework and ''acceptance-small'', see [[Testing Lustre Code]]. <br />
<br />
To initiate a loopback-based Lustre mount for local testing, run:<br />
<pre><br />
lustre/tests/llmount.sh<br />
</pre><br />
<br />
To clean up the loopback mount (reverse the actions of the ''llmount.sh'' script), run <pre><br />
lustre/tests/llmountcleanup.sh<br />
</pre></div>KenRawlings