[Pkg-lustre-svn-commit] r315 - /trunk/debian/README.build

[noel at users.alioth.debian.org]

Author: noel
Date: Mon Sep 17 11:29:43 2007
New Revision: 315

URL: http://svn.debian.org/wsvn/pkg-lustre/?sc=1&rev=315
Log:
added some information about building lustre (README.build)

Added:
    trunk/debian/README.build

Added: trunk/debian/README.build
URL: http://svn.debian.org/wsvn/pkg-lustre/trunk/debian/README.build?rev=315&op=file
==============================================================================
--- trunk/debian/README.build (added)
+++ trunk/debian/README.build Mon Sep 17 11:29:43 2007
@@ -1,0 +1,40 @@
+What to do in order to build lustre for a new kernel:
+
+1.)     Create a new lustre patch series for the new kernel (e.g. 2.6.23-vanilla.series ). 
+        This file have to be in ./lustre/kernel_patches/series/
+
+        To ease this, use the previous series (means copy 2.6.22-vanilla.series to 2.6.23-vanilla.series)
+
+2.)     Get the vanilla source for this kernel and try to apply the patches in this series. this could 
+        easily be done by using quilt. (Or you include them into linux-patch-lustre and call make-kpkg with 
+        the --added-patches=lustre option.
+
+3.)     If patches doesn't apply: Check why and port them. Check also for every patch if this patch is still 
+        needed on the new kernel. 
+
+4.)     If all patches apply: Try to build the kernel. If this fails you've to sort out this issues ;-) Have fun :)
+
+5.)     When the kernel is build successfully: Now try to build the ldiskfs kernel module for this kernel. (See
+        next section.)
+
+
+What to do in order to build ldiskfs for a new kernel:
+
+1.)     Create a new ldiskfs patch series for the new kernel (e.g ldiskfs-2.6.23-vanilla.series).
+        This file have to be in ./ldiskfs/kernel_patches/series/
+
+        To ease this, use the previous series (copy 2.6.22 to 2.6.23)
+
+2.)     Now try to build the kernel modules. 
+
+3.)     If the patch doesn't apply correctly (this is normal ;-)), start to have a look where are the difficulties 
+        and try to sort them out. After all patches apply cleanly try to build the modules. If this fails you'll 
+        have to look into the specific files, what is wrong there.
+
+4.)     After the modules build fine install them and reboot into the new kernel. After the system is up again try 
+        to load the modules. If this doesn't work you'll have to have a look on the error msg (see dmesg) and fix this
+        either in the kernel module or in the kernel itself.
+
+5.)     The last step: Do _many_ testing if the kernel module and the kernel really works... Please note that you shouldn't 
+        touch anything if you don't know what you are doing there. And of course: No warranty at all!
+