mirror of
https://github.com/SCST-project/scst.git
synced 2026-08-22 15:16:33 +00:00
Gleb Chesnokov
9bdffe6fe6
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.
SCST ISCSI Resource Agents Version 1.0 (c) 2012 Riccardo Bicelli (r.bicelli@gmail.com) and Linux HA Contributors This program is free software; you can redistribute it and/or modify it under the terms of version 2 of the GNU General Public License as published by the Free Software Foundation. If you find this program useful or if you modify it, please write me a mail. STATUS AND SAFETY These files are legacy example OCF resource agents. They are not built or exercised by this repository's CI. Review them against the current SCST sysfs interface and the OCF implementation used by the cluster before installing them. The agents perform privileged live operations. They load and unload kernel modules, start and stop iscsi-scstd, write SCST sysfs state, and force-close sessions. SCSTTarget also clears the active SCST configuration when it starts its own daemon. Do not run these agents without authorization for the exact host, targets, sessions, and backing devices. INSTALLATION Place files SCSTTarget and SCSTLun into pacemaker ocf directory (usually /usr/lib/ocf/resource.d or /usr/lib64/ocf/resource.d) EXAMPLE OF USAGE Assumptions: - you are using DRBD as backing device (/dev/drbd1) - your target iqn is iqn.2012-02.com.mysuperhasan:vdisk.lun - your nic reserved for iscsi is eth2 and your iscsi subnet is 192.168.103.x This is what your resource configuration in cib notation will look like: primitive DRBD_VOLUME ocf:linbit:drbd \ params drbd_resource="DRBDRESOURCE" \ op monitor interval="29" role="Master" \ op monitor interval="31" role="Slave" primitive ISCSI_IP ocf:heartbeat:IPaddr2 \ params ip="192.168.103.20" cidr_netmask="24" nic="eth2" \ op monitor interval="10s" primitive ISCSI_LUN ocf:scst:SCSTLun \ params target_iqn="iqn.2012-02.com.mysuperhasan:vdisk.lun" lun="0" \ path="/dev/drbd1" handler="vdisk_fileio" device_name="VDISK-LUN10" \ additional_parameters="nv_cache=1" \ op monitor interval="10s" timeout="120s" primitive ISCSI_TGT ocf:scst:SCSTTarget \ params iqn="iqn.2012-02.com.mysuperhasan:vdisk.lun" \ portals="192.168.103.20" \ op monitor interval="10s" timeout="120s" group GR_ISCSI ISCSI_TGT ISCSI_LUN ISCSI_IP ms MS_DRBD_VOLUME DRBD_VOLUME \ meta master-max="1" master-node-max="1" clone-max="2" \ clone-node-max="1" notify="true" colocation CO_ISCSI_ON_DRBD_VOLUME inf: GR_ISCSI MS_DRBD_VOLUME:Master order OR_DRBD_BEFORE_ISCSI inf: MS_DRBD_VOLUME:promote GR_ISCSI:start ORIGINAL TEST SCOPE The original testing covered DRBD or LVM over DRBD as the backing device, vdisk_fileio, and one LUN per target. This repository does not provide an automated validation environment for these agents. The agents contain CHAP configuration paths, but these are not validated here. ORIGINAL GIT REPOSITORY The agents were originally maintained at https://github.com/rbicelli/scst-ocf.git