From f875ebe2817d7b1ac4a3859fcf68b6c87ff69e83 Mon Sep 17 00:00:00 2001 From: Bart Van Assche Date: Sat, 13 Jun 2020 16:13:15 +0000 Subject: [PATCH 1/2] README.md: Add a reference to INSTALL.md git-svn-id: http://svn.code.sf.net/p/scst/svn/trunk@9013 d57e44dd-8a1f-0410-8b47-8ef2f437770f --- README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.md b/README.md index d7719f4bf..58d6c7ff0 100644 --- a/README.md +++ b/README.md @@ -12,6 +12,9 @@ project includes: 4. User space programs in the usr/ subdirectory, e.g. fileio_tgt. 5. Various documentation in the doc/ subdirectory. +Instructions for building and installing SCST are available in the INSTALL.md +file. + ## QLogic target driver Two QLogic target drivers are included in the SCST project. The driver in From 87bde8ab0e16259ddbd591bb1037d6a1bd4317e0 Mon Sep 17 00:00:00 2001 From: Bart Van Assche Date: Sat, 13 Jun 2020 16:22:00 +0000 Subject: [PATCH 2/2] fcst/README: Update this README file git-svn-id: http://svn.code.sf.net/p/scst/svn/trunk@9014 d57e44dd-8a1f-0410-8b47-8ef2f437770f --- fcst/README | 68 ++++++++++++----------------------------------------- 1 file changed, 15 insertions(+), 53 deletions(-) diff --git a/fcst/README b/fcst/README index 21c02d644..40b4f66ab 100644 --- a/fcst/README +++ b/fcst/README @@ -19,57 +19,19 @@ Building and Installing FCST is a kernel module that depends on libfc and SCST to provide FC target support. -To build for linux-2.6.34, do: +1. Build and install scst, fcst and scstadmin following the instructions + in the top-level INSTALL.md file. -1. Get the kernel source: +2. Install the FCoE admin tools: - KERNEL=linux-2.6.34 + apt-get install fcoe-utils lldpad || + dnf install fcoe-utils lldpad || + zypper install fcoe-utils open-lldp - cd /usr/src/kernels - URL_DIR=http://www.kernel.org/pub/linux/kernel/v2.6 - TARFILE=$KERNEL.tar.bz2 - wget -o $TARFILE $URL_DIR/$TARFILE - tar xfj $TARFILE - cd $KERNEL +3. Bring up SCST and configure the devices. -2. Apply patches needed for libfc target hooks and point-to-point fixes: +4. Bring up an FCoE initiator (we'll enable target mode on it later): - KDIR=/usr/src/kernels/$KERNEL - PDIR=/usr/src/scst/trunk/fcst/linux-patches # use your dir here - - cd $PDIR - for patch in `grep -v '^#' series-2.6.34` - do - (cd $KDIR; patch -p1) < $patch - done - -3. Apply SCST patches to the kernel - See trunk/scst/README - The readahead patches are not needed in 2.6.33 or later. - -4. Configure, make, and install your kernel - -5. Install SCST - See trunk/scst/README. Make sure you are building sysfs SCST build, - because FCST supports only it. You need to do - - cd trunk/scst - make - make install - -6. Make FCST - In the directory containing this README, just do - make - make install - -7. Install the FCoE admin tools, including dcbd and fcoeadm. - Some distros may have these. - You should be able to use the source at - http://www.open-fcoe.org/openfc/downloads/2.6.34/open-fcoe-2.6.34.tar.gz - -8. Bring up SCST and configure the devices. - -9. Bring up an FCoE initiator (we'll enable target mode on it later): modprobe fcoe fcoeadm -c eth3 @@ -77,7 +39,7 @@ To build for linux-2.6.34, do: over a full-duplex loss-less link (enable pause on both sides). Alternatively, the other end can be an FCoE switch. -10. Use fcc (part of the open-fcoe contrib tools in step 7) to see the +5. Use fcc (part of the open-fcoe contrib tools in step 7) to see the initiator setup. To get the FCoE port name for eth3 # fcc @@ -92,11 +54,11 @@ To build for linux-2.6.34, do: In the above example, there's one local host on eth3, and it's in a point-to-point connection with the remote initiator with Port_id 010101. -11. Load fcst +6. Load fcst modprobe fcst -12. Add any disks (configured in step 8) you want to export +7. Add any disks (configured in step 8) you want to export Note that you must have a LUN 0. LPORT=20:00:00:1b:21:06:58:21 # the local Port_Name @@ -105,10 +67,10 @@ To build for linux-2.6.34, do: echo add disk-name 0 > luns/mgmt echo add disk-name 1 > luns/mgmt -13. Enable the initiator: +8. Enable the initiator: echo 1 > $LPORT/enabled -14. As a temporary workaround, you may need to reset the interface - on the initiator side so it sees the SCST device as a target and - discovers LUNs. You can avoid this by bringing up the initiator last. +9. As a temporary workaround, you may need to reset the interface + on the initiator side so it sees the SCST device as a target and + discovers LUNs. You can avoid this by bringing up the initiator last.