Return to README CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / istgt

istgt

    1: The iSCSI target for FreeBSD 7.1 or later
    2: 
    3: This software (istgt) is the implementation of iSCSI target
    4: (refer to RFC3720 about iSCSI) for FreeBSD 7.1 or later.
    5: It includes iSCSI protocol processor and SPC-3 (SCSI Primary
    6: Commands - 3) based logical unit emulation.
    7: You can easily create over 2TB storage for iSCSI target.
    8: If necessary, you can configure to use multipath failover or
    9: MCS failover.
   10: 
   11: If you want use the command queuing, change QueueDepth key of
   12: the configuration. Because default is comment out, you only
   13: remove # from this line to make the parameter take effect.
   14: The command queuing is not yet stable. If you have any problem,
   15: comment out or specify 0 to disable it. The small QueueDepth
   16: may cause a problem. I recommend you to specify more than 32.
   17: 
   18: You can use a file or any raw device as the backing store.
   19: Microsoft Windows Server 2008 or Microsoft iSCSI initiator 2.08
   20: or later is recommended.
   21: Diskless iSCSI boot is tested with Intel PRO/1000 PT Server
   22: Adapter and Windows Server 2003/2008/2008R2/Windows7 RC.
   23: iSCSI install/boot is tested with gPXE 1.0.0 and WS2K8/2K8R2/W7.
   24: Intel Gigabit CT Desktop Adapter is tested with WS 2K8R2/W7.
   25: 
   26: This software is under development and less document.
   27: The format of the configuration file may frequently be changed.
   28: Please use it carefully.
   29: It is made based on the concept of my own MCS extra patch
   30: (release 20090125) for iscsi-target (netbsd-iscsi-20080207).
   31: 
   32: If you want to run FreeBSD in Hyper-V environment,
   33: please use my small kernel patch of reboot issue which can be
   34: downloaded below.
   35: 
   36: The latest version is available at:
   37: http://shell.peach.ne.jp/aoyama/
   38: 
   39: For FreeBSD initiator, please check here:
   40: ftp://ftp.cs.huji.ac.il/users/danny/freebsd/
   41: 
   42: Using path-through tape drive from Microsoft iSCSI Initiator:
   43: open registry of initiator by regedit.exe.
   44: change the value of MaxTransferLength to 0x10000 (65536).
   45: reboot Windows.
   46: (0000 is an instance number. It might be a different value.)
   47: 
   48: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Class\
   49: {4D36E97B-E325-11CE-BFC1-08002BE10318}\0000\Parameters\
   50: MaxTransferLength
   51: 
   52: Timeout of Microsoft iSCSI Initiator:
   53: If you want fast recovery from failure, try to decrease the value in
   54: above registry:
   55: LinkDownTime
   56: TCPConnectTime
   57: TCPDisconnectTime
   58: DelayBetweenReconnect
   59: 
   60: If you want to keep failed command, try to increase:
   61: MaxRequestHoldTime
   62: SrbTimeoutDelta
   63: 
   64: 
   65: External Libs:
   66:  o OpenSSL (shipped with FreeBSD)
   67:  o CAM (shipped with FreeBSD)
   68: 
   69: Tested Initiators:
   70:  o Microsoft Windows Server 2008 (builtin)
   71:  o Microsoft Windows Server 2008 R2 (builtin)
   72:  o Microsoft Windows 7 Ultimate x64 (builtin)
   73:  o Microsoft iSCSI Initiator 2.08 on WS2003
   74:  o Intel iSCSI Remote Boot 2.1.22
   75:  o Intel iSCSI Remote Boot 2.3.81
   76:  o Intel iSCSI Remote Boot 2.5.12 (CT Desktop Adapter)
   77:  o Intel iSCSI Remote Boot 2.7.44 (ET Dual Port Server Adapter)
   78:  o Sun VirtualBOX 2.1.2 (builtin)
   79:  o Sun VirtualBOX 3.0.12 (builtin)
   80:  o Sun VirtualBOX 3.1.2 (builtin)
   81:  o VMware ESXi 3.5 Update 3 (builtin)
   82:  o VMware ESXi 4.0 (builtin)
   83:  o VMware ESXi 4.1 Update 1 (builtin)
   84:  o VMware ESXi 5.0 (builtin)
   85:  o Xen Server 5.0 Update 3 (builtin)
   86:  o Xen Server 5.5 (builtin)
   87:  o FreeBSD 7.1 + iscsi 2.1.3
   88:  o FreeBSD 7.2 + iscsi 2.2.3
   89:  o FreeBSD 7.3 + iscsi 2.2.4
   90:  o FreeBSD 8.2 + isboot 0.2.3
   91:  o CentOS 5.2 + Open-iSCSI (package)
   92:  o Ubuntu 9.10 + Open-iSCSI (package)
   93:  o gPXE 1.0.0 + VirtualBox 3.1.2 on FreeNAS 0.7.1
   94:  o FreeNAS 0.7.1 (FreeBSD 7.2/7.3 + iscsi 2.2.4)
   95:  o FreeNAS 0.7.2 (FreeBSD 7.3 + iscsi 2.2.4)
   96: 
   97: Features:
   98:  o MCS/MPIO for failover (up to 255 concurrent sessions)
   99:  o Multipath I/O (only support Microsoft MPIO/VMware ESXi)
  100:  o SPC-3 Persistent Reservation for cluster nodes
  101:  o 64bit LBA for over 2TB
  102:  o Header/Data digest by CRC32C
  103:  o CHAP w/Mutual authentication
  104:  o Multiple LUNs and ACLs for portals
  105:  o IPv6/IPv4 dual support
  106:  (experimental features)
  107:  o Command Queuing (up to 255 depths, disabled by default)
  108:  o iSCSI boot with Intel PRO/1000 Server Adapters
  109:  o virtual DVD-ROM and virtual tape drive (DLT emulator)
  110:  o pass-through device (only support DA/SA/CD/CH type)
  111: 
  112: Current Limitations:
  113:  o logical unit is sharing with exclusive lock
  114:  o exclusive port w/asynchronous operation
  115:  o command queuing is incomplete for multiple initiators
  116:  o LUN1 and more are shared information of LUN0 (e.g. UnitInquiry)
  117:  o APTPL (Activate Persist Through Power Loss) is not supported
  118:  o TPGS is incomplete for multipath failover (disabled by default)
  119:  o path-through SA variable length must not exceed 65536 (CAM limit)
  120:  o maximum LUN is 15
  121:  o maximum PortalGroup are 1024
  122:  o maximum InitiatorGroup, LogicalUnit are 4096
  123:  o maximum mapping per target is 256
  124:  o maximum concurrent session identifier per target is 255
  125:  o maximum persistent reservation keys per target is 256
  126:  (most case of limitation is due to memory allocation and finding
  127:   method by linear search)
  128: 
  129: Special Thanks to:
  130: Isao Takatani (bug report and idea suggestion)
  131: Toshiya Shimpo of Meikohsha Information System Co.,Ltd
  132: Yoshio Takii of Meikohsha Information System Co.,Ltd
  133: 
  134: Author:
  135: Daisuke Aoyama <aoyama@peach.ne.jp>