Open-FCoE Wiki	Main Page | About | Help | FAQ | Special pages | Log in
	Printable version | Disclaimers | Privacy policy

FCoE SW Target Quickstart

From Open-FCoE Wiki

Contents 1 Caveat 2 Introduction 3 Configuration 4 Initial Setup 5 Further setup 6 Final configuration and usage 7 Using FCoE SW target with FCoE initiator

[edit] Caveat

This document may not be up to date for SW target setup. If you have suggestions on how to improve this document please mail the mailing list.

Our intent is to get the initiator in-kernel and then determine a correct way to implement a SW FCoE target. We realize that this can be frustrating for users without access to HW, but we simply don't have the resources to accomplish both the initiator and target simultaneously. We would be glad to advise any developer(s) wishing to work on a target implementation and the mailing list would be the appropriate place for those discussions.

The possibilities at the time of writing this seems to be adding hooks to the initiator and maintaining kernel target code on this site or improving the STGT project that currently has a FCoE target, in userspace, based on our original "pre-arch" code.

[edit] Introduction

Here is a quick set of instructions to setup FCoE SW target.

These instructions have not been tested and may contain errors. I must admit that while writing them I ran into a few problems that I had to workout on my own. Over time installation, configuration and usage of the initiator and target will improve.

[edit] Configuration

• Fedora 7 systems
• Intel NICs - e1000 driver
  • MTU = 2500
• static any IP addresses

[edit] Initial Setup

1. Clone the open-fcoe-target and open-fcoe repositories
   1. git clone git://open-fcoe.org/archive/open-fcoe-target.git
   2. git clone git://open-fcoe.org/archive/open-fcoe-target-user.git
2. Get and install the v2.6.23 tagged kernel
   1. git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6.git
   2. cd linux-2.6 && git-checkout v2.6.23
3. Get SCST and patch your kernel
   1. svn co https://scst.svn.sourceforge.net/svnroot/scst
   2. patch -p1 < <path-to-scst>/trunk/scst/kernel/scst_exec_req_fifo-2.6.23.patch
4. Get the HBAAPI
   1. hbaapi_src_2.2.tgz from http://sourceforge.net/projects/hbaapi/ and untar it
5. Build your kernel
   1. cd <path-to-2.6.23 kernel>
   2. I always copy in my last known good .config file and "make menuconfig", exit saving changes. There is no particular configuration that needs to be set outside of default settings.
   3. I did - make -j 12 && make modules && make modules_install && make install
   4. Modify your bootloader to boot your new kernel
   5. reboot

[edit] Further setup

The INSTALL document in open-fcoe-target is incorrect, you don't need the open-fcoe-upstream tree nor do you need to run the psrc.sh script.

1. Build SCST
   1. cd <path-to-scst>/trunk/scst/src
   2. make && make install
2. Build openfctgt
   1. cd <path-to-open-fcoe-target>
   2. make SCST=<path-to-scst>/trunk/scst install_tgt
3. Build the HBA API
   1. Follow the instructions in the <open-fcoe>/INSTALL doc 1b->1g
4. Build fcconf
   1. cd <path-to-open-fcoe>/usr
   2. make HBAAPI=<absolute-path-to-hbaapi-src> && make install

[edit] Final configuration and usage

I had some problems here. For some reason I kept getting a openfc.ko module in /lib/modules/2.6.23/extras/. It kept getting loaded and openfctgt.ko couldn't load because of duplicate symbols. Eventually I just insmod'd the openfctgt.ko and fcoe.ko modules by hand.

1. Install scstadmin
   1. cd <path-to-scst>/trunk/scstadmin
   2. cp scstadmin /usr/local/sbin/
   3. > /etc/scst.conf
   4. cp init.d/scst /etc/init.d/scst
      1. In the SCST_MODULES definition change qla2x00tgt to fcoe
2. Install lsscsi
   1. yum -y install lsscsi (there's probably a different tool that gets the same results)
3. Add a disk to SCST - my target has a second HDD
   1. lsscsi - my second disk is reported as "[2:0:0:0] disk ATA ST380817AS 3.42 /dev/sdb"
   2. echo "assign 2:0:0:0 dev_disk" > /proc/scsi_tgt/scsi_tgt
   3. echo "add 2:0:0:0 0" > /proc/scsi_tgt/groups/Default/devices
4. Start the target
   1. At this point I like to run wireshark
   2. fcconf <ethX> enable - where <ethX> is your device connected to the initiator.

Note that the target doesn't know it's a target and attempts FLOGIs. If you're not seeing FLOGIs from the target you have a problem.

[edit] Using FCoE SW target with FCoE initiator

Please read the FCoE Initiator_Quickstart to setup FCoE initiator, the FCoE SW target can be used back to back using crosswire ethernet connection between FCoE initiator and SW target ethernet interfaces.

Edit this page | Discuss this page | Page history | What links here | Related changes Main Page | About Open-FCoE Wiki | Find: This page has been accessed 1,369 times. This page was last modified 21:03, 13 August 2008.