From 0f132124b9aeec47ae469dcd43a786b2fefb686b Mon Sep 17 00:00:00 2001
From: Bart Van Assche <bvanassche@acm.org>
Date: Sun, 10 May 2009 18:28:09 +0000
Subject: [PATCH] Added more details.

git-svn-id: http://svn.code.sf.net/p/scst/svn/trunk@837 d57e44dd-8a1f-0410-8b47-8ef2f437770f
---
 srpt/README      |  2 +-
 srpt/README.ofed | 33 ++++++++++++++++++++++++++++++---
 2 files changed, 31 insertions(+), 4 deletions(-)

diff --git a/srpt/README b/srpt/README
index ebc968ffa..da30ce3f8 100644
--- a/srpt/README
+++ b/srpt/README
@@ -40,7 +40,7 @@ Proceed as follows to compile and install the SRP target driver:
    cd ${SCST_DIR}
    make -s scst_clean scst scst_install
    make -s srpt_clean srpt srpt_install
-   make -s scstadm_install
+   make -s scstadm scstadm_install
 
 3. Edit the installed file /etc/init.d/scst and add ib_srpt to the
    SCST_MODULES variable.
diff --git a/srpt/README.ofed b/srpt/README.ofed
index d9f6124d8..398795e12 100644
--- a/srpt/README.ofed
+++ b/srpt/README.ofed
@@ -20,6 +20,24 @@ Note: because during OFED installation the distro-provided InfiniBand
 kernel drivers are replaced, doing so voids the support contract
 offered by your Linux distributor.
 
+Please follow the instructions below carefully. Skipping a step may
+result in kernel modules that fail to load, a kernel oops or even a
+system that does no longer boot.
+
+
+Verifying the kernel version
+----------------------------
+
+Before installing the OFED distribution, it is very important to check
+the OFED release notes. Each OFED distribution has been tested
+carefully, but only against the kernel versions specified in
+docs/OFED_release_notes.txt (you can find this document in the OFED
+distribution). Make sure that you are using a supported kernel / OFED
+combination. As an example, if you want to use OFED 1.4.1 on an Ubuntu
+system, you will have to start with replacing the Ubuntu kernel by a
+kernel from kernel.org since OFED 1.4.1 has not been tested on any
+Ubuntu kernel.
+
 
 Compiling SRP against OFED
 --------------------------
@@ -28,17 +46,26 @@ Make sure that all necessary packages needed for kernel compilation
 have been installed (kernel headers, kernel source code, gcc,
 binutils, ...).
 
+Unload any loaded InfiniBand drivers:
+
+  /etc/init.d/opensmd stop
+  /etc/init.d/openibd stop
+
+Remove any distro-provided InfiniBand drivers:
+
+  rm -rf /lib/modules/$(uname -r)/kernel/drivers/infiniband
+
 Now locate the file Makefile.lib and patch it such that it supports
 the variable PRE_CFLAGS:
 
   cd /usr/src
   find -name Makefile.lib
   cd ...
-  patch -p0 < ${SCST_DIR}/srpt/patches/kernel-scripts-Makefile.lib.patch
+  patch -p0 < ${SCST_DIR}/srpt/patches/kernel-${KV}-scripts-Makefile.lib.patch
 
 Next, download and install the OFED package. Make sure to disable
-OFED's SRP target driver (srpt=n) and to enable the SRP tools
-(srptools=y). An example:
+OFED's SRP target driver (srpt=n) and to enable at least the
+kernel-ib, kernel-ib-devel and SRP tools packages. An example:
 
   wget http://www.openfabrics.org/downloads/OFED/ofed-1.4/OFED-1.4.tgz
   tar xzf OFED-1.4.tgz