mirror of
https://github.com/SCST-project/scst.git
synced 2026-08-28 03:46:42 +00:00
The iSER and distribution guides prescribe OFED 1.5 installation,
deleting packaged RDMA modules, patching kernel builds and applying
host-wide tuning. The Gentoo procedure targets SVN, while the bundled
OCF agents are neither built nor exercised by repository CI.
Commit 025574018e ("isert: Support building against MOFED without
patching the kernel build system") established the supported
header-selection model. Current Makefile conftests and isert-scst
sources define the remaining compatibility and transport limits.
Replace fixed OFED and tuning recipes with those sources and matching
vendor guidance. Reduce the Gentoo and resource-agent documents to
historical integration notes, and spell out their module, sysfs,
daemon, session and storage side effects before any reuse.
34 lines
1.5 KiB
Plaintext
34 lines
1.5 KiB
Plaintext
Building the iSER target against external RDMA stacks
|
|
======================================================
|
|
|
|
Status
|
|
------
|
|
|
|
This file previously contained an OFED 1.5.1 installation recipe. That recipe
|
|
stopped RDMA services, recursively removed distribution kernel modules, and
|
|
installed a stack for a specific historical kernel. Do not use those commands
|
|
on a current system.
|
|
|
|
Current build behavior
|
|
----------------------
|
|
|
|
The iscsi-scst Makefile builds isert-scst when the selected kernel build tree
|
|
enables InfiniBand support. Set KDIR or KVER as defined by the top-level
|
|
Makefile when building for a kernel other than the running kernel.
|
|
|
|
When /usr/bin/ofed_info is absent, the Makefile builds against the RDMA headers
|
|
from the selected kernel tree. When it reports MLNX_OFED or OFED-internal, the
|
|
Makefile selects its MOFED path and requires matching installed kernel
|
|
development packages and headers under /usr/src/ofa_kernel/default. It also
|
|
recognizes the legacy RPM-provided kernel-ib-devel and compat-rdma-devel header
|
|
layouts.
|
|
|
|
Install external RDMA stacks and their development packages only according to
|
|
the vendor documentation for the exact distribution and kernel. The headers
|
|
and Module.symvers used for isert-scst must match the RDMA modules that will be
|
|
loaded. Never remove distribution modules from /lib/modules manually to prepare
|
|
an SCST build.
|
|
|
|
See README.iser for iSER-specific configuration and limitations, and
|
|
../INSTALL.md for the repository build and installation workflow.
|