Lustre server machines are simple to setup with CentOS 5.5. Pre-built kernel images are available from Whamclouds build server. A number of different kernels and tools are continuasly built and tested. For this Walk-thru the centos-master-build will be used.
Prerequisite.
- A x86_64 machine with CentOS 5.5 installed. This machine has the hostname client-10.
Procedure
First step is to download and install a Lustre patched CentOS kernel. The subsequent step is to add in modules and tools necessary to build a Lustre filesystem.
Installing a patched kernel.
- Identify the recent, Lustre patched, kernel.
This can be found by either navigaing from the lustre-master page or by visiting a link the the last successful build for x86_64. - Identify the most recent kernel RPM.
Recent kernel builds are of the formkernel-2.6.18-194.17.1.el5_lustre.<buildid>.x86_64.rpm
- Download this RPM to the machine client-10.
- Install the kernel.
[root@client-10 ~]# rpm -ivh ./kernel-2.6.18-194.17.1.el5_lustre.<buildid>.x86_64.rpm Preparing... ########################################### [100%] 1:kernel ########################################### [100%] [root@client-10 ~]#
- Reboot
- Verify that the new kernel has been booted:
[root@client-10 ~]# uname -a Linux client-10.lab.whamcloud.com 2.6.18-194.17.1.el5_lustre.gdfe90dc #1 SMP Sun Mar 13 03:18:21 EET 2011 x86_64 x86_64 x86_64 GNU/Linux
Installing Ldiskfs.
- From the page that linked to the kernel, identify the Lustre modules RPM
The package will be named in the formlustre-ldiskfs-3.3.0-2.6.18_194.17.1.el5_lustre.<buildid>.x86_64.rpm
- Download the Lustre modules RPM.
- Install the RPM.
[root@client-10 ~]# rpm -ivh ./lustre-ldiskfs-3.3.0-2.6.18_194.17.1.el5_lustre.<buildid>.x86_64.rpm Preparing... ########################################### [100%] 1:lustre-ldiskfs ########################################### [100%] [root@client-10 ~]#
Install Lustre modules.
- From the page that linked to the kernel, identify the Lustre modules RPM
The package will be named in the formlustre-modules-2.0.59-2.6.18_194.17.1.el5_lustre.<buildid>.x86_64.rpm
- Download the Lustre modules RPM.
- Install the RPM.
[root@client-10 ~]# rpm --force -ivh ./lustre-modules-2.0.59-2.6.18_194.17.1.el5_lustre.gdfe90dc_g98bf9c9.x86_64.rpm Preparing... ########################################### [100%] 1:lustre-modules ########################################### [100%] [root@client-10 ~]#
Install e2fsprogs.
e2fsprogs is built in a project separate from the Lustre kernel builds. e2fsprogs is found at http://build.whamcloud.com/job/e2fsprogs-master/ on the Whamcloud build server.
- Identify the most recent build of e2fsprogs.
The RPM will have a name in the form:e2fsprogs-1.41.90.wc3-0redhat.x86_64.rpm
- Download the most recent RPM.
- Install the RPM
NOTE The first reboot after installing e2fsprogs may take longer than normal, especially if the root filesystem is large.
Testing
Now that you have all the components of a Lustre system installed, you can test them.
This is covered in a separate wiki page: Testing a Lustre filesystem