WEB updates for release 1.0.0
[mirror/scst/.git] / www / target_iscsi.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">\r
2 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">\r
3 <head>\r
4 <meta name="Keywords" content="Generic SCSI Target Middle Level for Linux, iSCSI, iSCSI target" />\r
5 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />\r
6 <meta name="author" content="Daniel Fernandes"/>\r
7 <meta name="Robots" content="index,follow" />\r
8 <link rel="stylesheet" href="images/Orange.css" type="text/css" />      \r
9 <title>SCST: Generic SCSI Target Middle Level for Linux</title>\r
10 </head>\r
11 \r
12 <body>\r
13 <!-- wrap starts here -->\r
14 <div id="wrap"> \r
15         <div id="header">       \r
16                 <div class="logoimg"></div><h1 id="logo"><span class="orange"></span></h1>\r
17                 <h2 id="slogan">SCSI Target Middle Level for Linux</h2>\r
18         </div>          \r
19                 \r
20         <div id="menu">\r
21                 <ul>\r
22                         <li><a href="index.html">Home</a></li>
23                         <li><a href="http://www.sourceforge.net/projects/scst">Main</a></li>\r
24                         <li id="current"><a href="targets.html">Drivers</a></li>\r
25                         <li><a href="downloads.html">Downloads</a></li>\r
26                         <li><a href="scstvsstgt.html">SCST vs STGT</a></li>             \r
27                 </ul>\r
28         </div>\r
29         \r
30         <!-- content-wrap starts here -->       \r
31         <div id="content-wrap">
32                         <div id="sidebar">\r
33                                 <h1>Target Drivers</h1>\r
34                                 <ul class="sidemenu">
35                                         <li><a href="target_iscsi.html">iSCSI-SCST</a></li>
36                                         <li><a href="target_qla22xx_23xx.html">QLogic FC 22xx/23xx</a></li>
37                                         <li><a href="target_qla_isp.html">QLogic FC ISP</a></li>
38                                         <li><a href="target_srp.html">SCSI RDMA Protocol(SRP)</a></li>
39                                         <li><a href="target_lsi.html">LSI/MPT cards</a></li>
40                                         <li><a href="target_fcoe.html">Open-FCoE Target SW</a></li>\r
41                                         <li><a href="target_old.html">Old Unsupported</a></li>\r
42                                 </ul>
43                                 <h1>User utilities</h1>
44                                 <ul class="sidemenu">
45                                         <li><a href="scst_admin.html">SCST Admin Utility</a></li>
46                                         <li><a href="handler_fileio_tgt.html">FILEIO_TGT handler</a></li>
47                                 </ul>\r
48                         </div>          
49                         \r
50                         <div id="main">\r
51                                 <h1>ISCSI target driver iSCSI-SCST</h1>
52                                 <p><strong>ISCSI-SCST</strong> is a forked (with all respects) version of <strong>IET</strong> with updates to work 
53                                 over <strong>SCST</strong> as well as with many improvements and bugfixes. The reason of fork is that the necessary 
54                                 changes are intrusive and with the current <strong>IET</strong> merge policy, where only simple bugfix-like patches,
55                                  which doesn't touch the core code, could be merged, it is very unlikely that they will be merged in the main 
56                                  <strong>IET</strong> trunk.</p>
57                                 
58                                 <p><strong>ISCSI-SCST</strong> has the following major advantages over the mainline <strong>IET</strong>:
59                                 <ul>
60                                         <li><span>It uses full power of <strong>SCST core</strong> without loosing any existing feature (except, maybe, illegal
61                                          from SCSI specifications point of view MPIO). Namely, you can additionally use with it:
62                                          <ul>
63                                                 <li><span><strong>Pass-through mode with one to many relationship</strong>, i.e. when multiple initiators can connect to the 
64                                                 exported pass-through devices. For instance, you can safely export your parallel
65                                                 <strong>SCSI tape</strong> or <strong>tape library</strong> on 
66                                                 your iSCSI net and multiple initiators can share it without risk of data loss because of the 
67                                                 shared usage. Existing "rawio" patch for IET supports only non-enforced 1:1 
68                                                 relationship, so it is unsafe to use it in multiple initiators environments.</span></li>
69                                                 <li><span><strong>More advances devices visibility management</strong>, when different initiators can see different set of 
70                                                 devices with different access permissions from the same target.</span></li>
71                                                 <li><span><strong>O_DIRECT</strong>, i.e. "<strong>BLOCKIO</strong> on files", mode, which has all advantages 
72                                                 of <strong>BLOCKIO</strong>, but also supports files on file systems. Sometimes, in the appropriate cases, 
73                                                 this mode can make performance difference in 100% or even more.</span></li>
74                                                 <li><span>With <strong>4KB blocks</strong> you can forget about abysmal write performance caused by misaligned partitions. 
75                                                 All modern OS'es, including Windows starting from, at least, Windows 2000, work perfectly with 4KB block 
76                                                 devices without any additional storage or handling overhead.</span></li>
77                                                 <li><span><strong>Virtual CD/DVD-ROMs</strong> without necessity for manual patching.</span></li>       
78                                                 <li><span>Ability to create target devices emulators in the <strong>user space</strong>.</span></li>
79                                                 <li><span>Ability to create <strong>multi-transport SCSI targets</strong>, which can export (possibly, the same) 
80                                                 devices over multiple transports.</span></li>                                                                                                                            
81                                          </ul>                                   
82                                          </span></li>
83                                          <li><span>It has many code improvements and cleanups, including <strong>stability and iSCSI RFC violations fixes</strong>. 
84                                           Many IET users use it for ages without problems, so they consider it problemless. But,
85                                           in fact, unfortunately, it isn't so.
86                                           IET works well only on "fast" paths and regularly used branches, in many other less used
87                                           cases IET has various problems, from simply ignoring error processing, as it is with memory 
88                                           allocations, and crashing itself with BUG() macro, as it is for malformed packets from initiators, to possible data
89                                           corruption. See, for instance, <a href="http://communities.vmware.com/thread/53797?tstart=0&start=15">this</a>
90                                           thread on a VMware forum about in which <strong>Russian roulette</strong> IET users play using it with VMware.
91                                           ChangeLog file lists most noticeable fixes, but there were a lot of many other smaller ones.</span></li>
92                                          <li><span>Due to reworked I/O architecture and <strong>SCST</strong> backend <strong>iSCSI-SCST</strong> has
93                                           better performance in many cases. In future with upcoming improvements in <strong>SCST core</strong>, like zero-copy 
94                                           with Linux cache <strong>FILEIO</strong>, the performance difference is going to be even bigger. Currently in 
95                                           tests from a single initiator over a single connection on 1GbE hardware over <strong>FILEIO</strong> vdisk 
96                                           <strong>iSCSI-SCST</strong> with default settings usually outperforms tuned for best
97                                           performance <strong>IET</strong> a on <strong>3-30%</strong>. The difference is especially noticeably with real storage,
98                                           not NULLIO or RAM disks.
99                                           On 10GbE hardware the performance difference is often as high as <strong>100-200%</strong> or even more.
100                                           With higher number of initiators the difference will be even bigger. This is because 
101                                           <strong>iSCSI-SCST</strong> has less commands processing overhead per command, hence has smaller processing 
102                                           latency and puts less load on CPU.                    
103                                 </ul></p>\r
104                                 <p>Also, in contrast to <strong>IET, iSCSI-SCST</strong> is open for any new development, modifications and 
105                                 improvements, so people who want to fix or implement something new will not have to keep and maintain separate 
106                                 patches as it is currently necessary with <strong>IET</strong>. <strong>ISCSI-SCST</strong> is actively
107                                  developed and going to gain in the future new features like support for multiple connections per session, error recovery 
108                                  levels >0, etc., which eventually make it really <i>"Enterprise"</i>.</p>
109                                 
110                                 <p>If you are an IET user before installation carefully read README files of both iSCSI-SCST and 
111                                 the SCST core. Especially pay attention that now the LUN information for iSCSI-SCST is configured not using 
112                                 iscsi-scstd.conf file in /etc, but using corresponding SCST facilities. This is because now the responsibilities 
113                                 are divided (as it should be) between the target driver (iSCSI-SCST) and the SCST core: target driver is 
114                                 responsible for handling targets and their parameters, SCST core is responsible for handling backstorage.</p>
115
116                                 <p>The latest stable version is 1.0.0. Requires Linux kernel version 2.6.16.x or higher and SCST version 1.0.0 or higher. 
117                                 Tested mostly on i386 and x86_64, but should work on any other supported by Linux platform.</p>
118                                 <p>You can find the latest development version of this driver in the SCST SVN. See the download page how to setup 
119                                 access to it.</p>
120                                 <p class="post-footer align-right">                                     \r
121                                         <a href="https://sourceforge.net/project/showfiles.php?group_id=110471&package_id=283228" class="readmore">Download</a>                         \r
122                                         <a href="http://scst.svn.sourceforge.net/" class="readmore">SCST SVN Repository</a>\r
123                                 </p>
124                         </div> \r
125         </div>\r
126 </div>          \r
127 \r
128 <!-- footer starts here -->             \r
129                 <div id="footer">\r
130                         <p>\r
131                         &copy; Copyright 2008 <strong>SCST (SCSI Target Middle Level for Linux)</strong>&nbsp;&nbsp;  \r
132                         Design by: <b><font color="#EC981F">Daniel Fernandes</font></b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;         \r
133                         \r
134                         </p>            \r
135                 </div>  \r
136 <!-- footer ends here -->       \r
137 \r
138 </body>\r
139 </html>