mirror of
https://github.com/SCST-project/scst.git
synced 2026-05-19 19:51:27 +00:00
9b246065ab
svn+ssh://yanb123@svn.code.sf.net/p/scst/svn/branches/3.0.x ........ r5746 | bvassche | 2014-09-03 12:12:08 +0300 (Wed, 03 Sep 2014) | 1 line srpt/README: Fix SLES patch instructions (merge r5682 from trunk) ........ r5747 | bvassche | 2014-09-03 12:14:20 +0300 (Wed, 03 Sep 2014) | 1 line srpt/Makefile: SLES + Mellanox OFED build fix (merge r5679:5681 from trunk) ........ r5748 | bvassche | 2014-09-03 12:17:39 +0300 (Wed, 03 Sep 2014) | 1 line Add kernel 3.16 nightly build infrastructure (merge r5719 from trunk) ........ r5749 | bvassche | 2014-09-03 12:19:07 +0300 (Wed, 03 Sep 2014) | 1 line ib_srpt: Kernel 3.17 build fix (merge r5725 from trunk) ........ r5750 | bvassche | 2014-09-03 12:22:38 +0300 (Wed, 03 Sep 2014) | 1 line nightly build: Add kernel 3.16.1 (merge r5651:5720 from trunk) ........ r5756 | bvassche | 2014-09-03 15:33:33 +0300 (Wed, 03 Sep 2014) | 1 line scst.h: Make vzalloc() available on RHEL 6.0 (merge r5752 from trunk) ........ r5757 | bvassche | 2014-09-03 15:35:49 +0300 (Wed, 03 Sep 2014) | 2 lines scst_vdisk: RHEL 6.0 build fix (merge r5754:5755 from trunk) ........ r5759 | bvassche | 2014-09-03 16:44:53 +0300 (Wed, 03 Sep 2014) | 1 line scst.h: RHEL 5.10 build fix (merge r5758 from trunk) ........ r5761 | bvassche | 2014-09-03 16:53:03 +0300 (Wed, 03 Sep 2014) | 1 line scst.h: RHEL 5.10 build fix (merge r5760 from trunk) ........ r5763 | bvassche | 2014-09-03 17:01:04 +0300 (Wed, 03 Sep 2014) | 1 line scst.h: Fix definition of __aligned() (merge r5762 from trunk) ........ r5765 | bvassche | 2014-09-03 17:25:53 +0300 (Wed, 03 Sep 2014) | 1 line scst_vdisk: Use parentheses around && inside || ........ r5766 | bvassche | 2014-09-03 17:27:09 +0300 (Wed, 03 Sep 2014) | 1 line Update for kernel 3.16 (merge r5717 from trunk) ........ r5768 | bvassche | 2014-09-04 15:45:59 +0300 (Thu, 04 Sep 2014) | 1 line ib_srpt: Version 3.0.0 ........ r5770 | bvassche | 2014-09-04 16:02:42 +0300 (Thu, 04 Sep 2014) | 1 line iscsi-scst: Build fix for IPV6=n (merge r5732 from trunk) ........ r5771 | bvassche | 2014-09-04 16:06:38 +0300 (Thu, 04 Sep 2014) | 1 line iscsi-scst: Micro-optimize cmnd_prepare_recv_pdu() (merge r5735 from trunk) ........ r5772 | bvassche | 2014-09-04 16:11:23 +0300 (Thu, 04 Sep 2014) | 1 line scripts/generate-patched-kernel: Fix for invocation from current directory (merge r5659 and r5745 from trunk) ........ r5773 | bvassche | 2014-09-04 16:13:52 +0300 (Thu, 04 Sep 2014) | 1 line scripts/kernel-functions: Handle 3.x.0 kernel versions correctly (merge r5658 and r5661 from trunk) ........ r5774 | bvassche | 2014-09-04 16:29:18 +0300 (Thu, 04 Sep 2014) | 1 line Add support for the RHEL 7 kernel (merge r5710:5711 from trunk) ........ r5775 | bvassche | 2014-09-04 16:44:08 +0300 (Thu, 04 Sep 2014) | 1 line Forbid using '.' in PR and mode page file names (merge r5702 from trunk) ........ r5776 | bvassche | 2014-09-04 16:46:14 +0300 (Thu, 04 Sep 2014) | 1 line scst_pres: Make a few error messages more clear (merge r5733 from trunk) ........ r5777 | bvassche | 2014-09-04 16:49:12 +0300 (Thu, 04 Sep 2014) | 1 line Pass-through error handling fix (merge r5703 from trunk) ........ r5778 | bvassche | 2014-09-04 16:55:04 +0300 (Thu, 04 Sep 2014) | 1 line scstadmin: Suppress a Perl warning (merge r5731 from trunk) ........ git-svn-id: http://svn.code.sf.net/p/scst/svn/branches/3.0.x-iser@5784 d57e44dd-8a1f-0410-8b47-8ef2f437770f
112 lines
3.6 KiB
Plaintext
112 lines
3.6 KiB
Plaintext
SCSI RDMA Protocol (SRP) Target driver for Linux
|
|
=================================================
|
|
|
|
Introduction
|
|
------------
|
|
|
|
The SRP target driver has been designed to work on top of the Linux
|
|
InfiniBand kernel drivers. While all recent Linux distributions
|
|
include recent versions of the InfiniBand drivers, the only way to
|
|
obtain the latest available InfiniBand drivers is by installing the
|
|
OFED software stack.
|
|
|
|
The OFED stack is distributed by the OpenFabrics Alliance (OFA). The
|
|
mission of the OpenFabrics Alliance is to is to develop, distribute
|
|
and promote a unified, transport-independent, open-source software
|
|
stack for RDMA-capable fabrics and networks, including InfiniBand and
|
|
Ethernet.
|
|
|
|
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.5.1 on an Ubuntu
|
|
system, you will have to start with replacing the Ubuntu kernel by a
|
|
kernel from kernel.org since OFED 1.5.1 has not been tested on any
|
|
Ubuntu kernel.
|
|
|
|
|
|
Compiling SRP against OFED
|
|
--------------------------
|
|
|
|
Make sure that all necessary packages needed for kernel compilation
|
|
have been installed (kernel headers, 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
|
|
rm -rf /lib/modules/$(uname -r)/kernel/drivers/net/mlx4
|
|
|
|
Now locate the file Makefile.lib and patch it such that it supports
|
|
the variable PRE_CFLAGS:
|
|
|
|
if [ -e /lib/modules/$(uname -r)/build/scripts/Makefile.lib ]; then
|
|
cd /lib/modules/$(uname -r)/build
|
|
else
|
|
cd /usr/src/linux-$(uname -r | sed 's/\(-default\|-trace\|-xen\)$//;s/\.[0-9]\+\.[0-9]\+\.[0-9]\+\.PTF$//')
|
|
fi
|
|
patch -p1 < ${SCST_DIR}/srpt/patches/kernel-${KV}-pre-cflags.patch
|
|
|
|
Next, download and install the OFED package. Make sure to disable
|
|
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.5.1/OFED-1.5.1.tgz
|
|
tar xzf OFED-1.5.1.tgz
|
|
cd OFED-1.5.1
|
|
cat <<EOF >ofed.conf
|
|
libibverbs=y
|
|
libibverbs-utils=y
|
|
libmthca=y
|
|
libmlx4=y
|
|
libcxgb3=y
|
|
libnes=y
|
|
libipathverbs=y
|
|
librdmacm=y
|
|
librdmacm-utils=y
|
|
mstflint=y
|
|
ofed-docs=y
|
|
ofed-scripts=y
|
|
kernel-ib=y
|
|
kernel-ib-devel=y
|
|
ibvexdmtools=y
|
|
qlgc_vnic_daemon=y
|
|
core=y
|
|
mthca=y
|
|
mlx4=y
|
|
mlx4_en=y
|
|
cxgb3=y
|
|
nes=y
|
|
ipath=y
|
|
ipoib=y
|
|
opensm=y
|
|
opensm-libs=y
|
|
srpt=n
|
|
srptools=y
|
|
perftest=y
|
|
EOF
|
|
./install.pl -c ofed.conf
|
|
|
|
Now continue with the installation instructions you can find in the
|
|
SCST-SRPT README file. The Makefile included with SCST-SRPT detects
|
|
whether OFED has been installed, and if so, compiles SCST-SRPT with
|
|
the OFED kernel headers instead of with the regular kernel headers.
|