Files
scst/iscsi-scst/README.iser_ofed
Gleb Chesnokov 9bdffe6fe6 iscsi-scst: Retire obsolete integration advice
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.
2026-08-21 10:05:36 +03:00

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.