From e0f145fafbf5a2d378c08d8d949a759378d29afc Mon Sep 17 00:00:00 2001 From: Linda Bebernes Date: Tue, 1 Oct 2013 16:06:36 -0700 Subject: [PATCH] LUDOC-57 installation: Added section describing installing Lustre with OFED Added section to Chapter 29 "Installing from Source, that describes a procedure for installing Lustre with a third-party network stack using OFED as an example. Signed-off-by: Linda Bebernes Change-Id: Idd6fce25e7f72e9bf2e6f29b4e7ce51791a5b735 Reviewed-on: http://review.whamcloud.com/7805 Tested-by: Hudson Reviewed-by: Minh Diep Reviewed-by: Cliff White Reviewed-by: Richard Henwood --- InstallingLustreFromSourceCode.xml | 88 ++++++++++++++++++++++++++++++++------ 1 file changed, 76 insertions(+), 12 deletions(-) diff --git a/InstallingLustreFromSourceCode.xml b/InstallingLustreFromSourceCode.xml index f4208dc..a61d541 100644 --- a/InstallingLustreFromSourceCode.xml +++ b/InstallingLustreFromSourceCode.xml @@ -1,6 +1,9 @@ - Installing a Lustre* File System from Source - Code + <indexterm + xmlns:xi="http://www.w3.org/2001/XInclude"> + <primary>installing</primary> + <secondary>from source code</secondary> + </indexterm> Installing a Lustre* File System from Source Code This chapter describes how to create a customized Lustre* server kernel from source code. Sections included are: @@ -28,9 +31,11 @@ xmlns:xlink="http://www.w3.org/1999/xlink" linkend="installinglustre"/>.
- - <indexterm><primary>installing</primary><secondary>from source</secondary></indexterm> - Overview and Prerequisites + <indexterm> + <primary>installing</primary> + <secondary>from source</secondary> + <tertiary>prerequisites</tertiary> + </indexterm>Overview and Prerequisites To install Lustre from source code, the following are required: @@ -150,7 +155,7 @@ required if a new kernel is needed for a Lustre server.
-
+
Preparing the Lustre Source To prepare the Lustre source, complete these steps. @@ -163,7 +168,8 @@ required if a new kernel is needed for a Lustre server. - Switch to the user called build and change the directory to the users home directory: + Switch to the user called build and change the directory to + the users home directory: # su build $ cd $HOME @@ -171,7 +177,8 @@ $ cd $HOME - Get the MASTER branch of the Lustre software from the Lustre software git repository: + Get the MASTER branch of the Lustre software from the Lustre software git + repository: # git clone git://git.hpdd.intel.com/fs/lustre-release.git # cd lustre-release @@ -317,7 +324,7 @@ Now at patch patches/jbd2-jcberr-2.6-rhel6.patch installing from source - packaging + installing Lustre RPMs Building the Lustre RPMs This section describes how to configure the patched kernel to work with the Lustre software and how to create and install the Lustre packages (RPMs). @@ -414,8 +421,12 @@ lustre-modules-2.0.61-2.6.32-358.14.1.el6_lustre.x86_64_g0533e7b.x86_64.rpm lustre-source-2.0.61-2.6.32-358.14.1.el6_lustre.x86_64_g0533e7b.x86_64.rpm lustre-tests-2.0.61-2.6.32-358.14.1.el6_lustre.x86_64_g0533e7b.x86_64.rpm
-
- Installing the Lustre Kernel +
+ <indexterm> + <primary>installing</primary> + <secondary>from source</secondary> + <tertiary>installing the Lustre kernel</tertiary> + </indexterm>Installing the Lustre Kernel To install the Lustre kernel, complete these steps. As root, install the kernel: @@ -445,9 +456,62 @@ client-10login:
+
+ <indexterm> + <primary>installing</primary> + <secondary>from source</secondary> + <tertiary>building Lustre with OFED</tertiary> + </indexterm>Building a Lustre File System with a Third-party Network Stack on OFED + (Optional) + When using third-party network hardware, you must follow a specific process to install + and recompile the Lustre software. This section provides an installation example that shows + how to build Lustre release 2.4.x when using the OpenFabrics Enterprise Distribution (OFED*) + version 3.5-1 open-source software. The same process can be used for other third-party + network stacks by replacing the OFED installation procedure and using the appropriate + --with option when configuring the Lustre source code. + + Install the Lustre kernel (see ). + + + Compile and install the OFED stack. As root, enter: + # cd /usr/src +# tar –zxvf OFED-3.5-1.tgz +# cd OFED-3.5-1 +# ./install.pl + A directory /usr/src/compat-rdma is created. + + + Configure and build Lustre source code: + + + Install the Lustre source. This can be done via RPM or git (see ). + + + Configure and build the Lustre source code + $ cd ~/lustre-release +$ sh ./autogen.sh + + + + + The ./configure --help command shows a list of all the + --with options. All third-party network stacks are built in this + manner.$ ./configure --with-linux=/usr/src/kernels/$(uname –r) --with-o2ib=/usr/src/compat-rdma +$ make +$ make rpms + The make rpms command output shows the location of the generated + RPMs. +
- Installing and Testing a Lustre File System + <indexterm> + <primary>installing</primary> + <secondary>from source</secondary> + <tertiary>testing a Lustre file system</tertiary> + </indexterm>Installing and Testing a Lustre File System This section describes how to install the Lustre RPMs and run the Lustre test suite.
-- 1.8.3.1