mirror of
https://github.com/SCST-project/scst.git
synced 2026-05-21 20:51:27 +00:00
b3b4702bcb
As Mikko Kortelainen <kordex@gmail.com> explained on the SCST IRC channel, it's not necessary to replace the qla2xxx directory in the kernel source tree in order to build the SCST qla2x00t target driver. Also, if neither SCSI pass-through nor iSCSI will be used rebuilding the kernel tree can be skipped entirely. The patch below updates the qla2x00t howto accordingly, and also implements the following changes: - Fix everything the W3C HTML validator complains about: - Add DOCTYPE declaration. - Add charset declaration. - Change </br> into <br> since </br> is invalid. - Change one occurrence of & into &. - Use proper HTML constructs for numbered and unnumbered enumerations. - Use a fixed-sized font and the brown color for all computer output text (via inline CSS). - Use hyperlinks to refer to other steps. - Fix spelling errors. - Merge the Debian and non-Debian howto's because the differences are so small that it's not justified to maintain two different documents. git-svn-id: http://svn.code.sf.net/p/scst/svn/trunk@3936 d57e44dd-8a1f-0410-8b47-8ef2f437770f
204 lines
12 KiB
HTML
204 lines
12 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<html>
|
|
<head>
|
|
<meta name="Keywords" content="Generic SCSI Target Subsystem for Linux, SCST, SCSI target">
|
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
|
<meta name="author" content="Daniel Fernandes">
|
|
<meta name="Robots" content="index,follow">
|
|
<meta name="verify-v1" content="N5TwpSXr8cNkQf0gvE3F3sv+TPHL15k4dTo+ZQCeV9Q=">
|
|
<link rel="stylesheet" href="images/Orange.css" type="text/css">
|
|
<title>SCST: A Generic SCSI Target Subsystem for Linux</title>
|
|
</head>
|
|
|
|
<body>
|
|
<div id="wrap">
|
|
<div id="header">
|
|
<div class="logoimg"></div><h1 id="logo"><span class="orange"></span></h1>
|
|
<h2 id="slogan">Generic SCSI Target Subsystem for Linux</h2>
|
|
</div>
|
|
<div id="menu">
|
|
<ul>
|
|
<li id="current"><a href="index.html">Home</a></li>
|
|
<li><a href="http://www.sourceforge.net/projects/scst">Main</a></li>
|
|
<li><a href="http://sourceforge.net/news/?group_id=110471">News</a></li>
|
|
<li><a href="targets.html">Drivers</a></li>
|
|
<li><a href="downloads.html">Downloads</a></li>
|
|
<li><a href="contributing.html">Contributing</a></li>
|
|
<li><a href="comparison.html">Comparison</a></li>
|
|
<li><a href="users.html">Users</a></li>
|
|
<li><a href="solutions.html">Solutions</a></li>
|
|
</ul>
|
|
</div>
|
|
<div id="content-wrap">
|
|
<div id="main">
|
|
<h1>Generic SCSI Target Subsystem for Linux</h1>
|
|
|
|
<p>The generic SCSI target subsystem for Linux (SCST) allows creation of sophisticated storage devices
|
|
from any Linux box. Those
|
|
devices can provide advanced
|
|
functionality, like replication, thin provisioning,
|
|
deduplication, high availability,
|
|
automatic backup, etc. Another class of such devices
|
|
are Virtual Tape Libraries (VTL)
|
|
as well as other disk-based backup solutions.</p>
|
|
<p>SCST devices can use any link which supports
|
|
SCSI-style data exchange: <strong>iSCSI</strong>, <strong>Fibre Channel</strong>, <strong>FCoE</strong>,
|
|
<strong>SAS</strong>,
|
|
<strong>InfiniBand (SRP)</strong>, <strong>Wide (parallel) SCSI</strong>, etc.</p>
|
|
<p>It might
|
|
well be that your favorite storage appliance is running SCST in the firmware.</p>
|
|
|
|
<p>SCST project consists from a set of subprojects: generic SCSI target mid-layer itself (SCST core)
|
|
with a set of device handlers as well as target drivers
|
|
and user space utilities.
|
|
|
|
<h1>Features of SCST Core</h1>
|
|
<ul>
|
|
<li><span>SCST core provides unified,
|
|
consistent interface between SCSI target drivers and
|
|
Linux kernel as well as between Linux kernel and storage backend
|
|
handlers, connecting target drivers with real or emulated storage backend.</span></li>
|
|
<li><span>SCST core performs all required pre- and post- processing of incoming requests as well as
|
|
necessary error recovery.</span></li>
|
|
<li><span>SCST core undertakes most problems, related to execution contexts, thus practically eliminating one of the most
|
|
complicated problem in the kernel drivers development. For example, target drivers for Marvell
|
|
SAS adapters or for InfiniBand SRP are less 3000 lines of code long.</span></li>
|
|
<li><span>Very low overhead and fine-grained locks allow to reach the
|
|
maximum performance and scalability. Particularly, incoming requests can be processed in
|
|
the caller's context or in one of the internal SCST core's tasklets without any
|
|
extra context switches.</span></li>
|
|
<li><span>Device handlers architecture allows various I/O
|
|
modes in backstorage handling. For example, pass-through device handlers allow to export real
|
|
SCSI hardware and vdisk device handler allows to export files as virtual disks.</span></li>
|
|
<li><span>Advanced per-initiator devices visibility management (LUN masking) allows different
|
|
initiators to see different set of devices with different access permissions. For instance,
|
|
initiator A could see exported from target T devices X and Y read-writable, and initiator B from
|
|
the same target T could see devices Y read-only and Z read-writable.
|
|
This feature is required for hardware targets, which don't have ability to create
|
|
virtual targets (SAS adapters, for instance).</span></li>
|
|
<li><span>SCST core emulates necessary functionality of SCSI host adapter, because from remote initiators' point of view
|
|
a SCSI target acts as a SCSI host with its own devices. This is especially important in pass-through mode with
|
|
one to many relationship, i.e. when multiple initiators can connect to the exported pass-through
|
|
devices. You can find more deep elaboration why it is needed in <a href="http://www.mail-archive.com/linux-scsi@vger.kernel.org/msg06911.html">this</a>
|
|
message in thread "Question for pass-through target design" in linux-scsi mailing list. Some of the emulated functions are the following:</span>
|
|
<ul>
|
|
<li><span>Generation of necessary UNIT ATTENTIONs, their storage and delivery to all connected
|
|
remote initiators.</span></li>
|
|
|
|
<li><span>RESERVE/RELEASE functionality.</span></li>
|
|
|
|
<li><span>All types of RESETs and other task management functions.</span></li>
|
|
|
|
<li><span>REPORT LUNS command as well as SCSI address space management in order to have consistent
|
|
address space on all remote initiators, since local SCSI devices could not know about each
|
|
other to report via REPORT LUNS command. Additionally, SCST core responds with error on all
|
|
commands to non-existing devices and provides access control, so different remote
|
|
initiators could see different set of devices.</span></li>
|
|
|
|
<li><span>Other necessary functionality (task attributes, etc.) as specified in SCSI standards.</span></li>
|
|
</ul>
|
|
</li>
|
|
|
|
<li><span>SCST core has multithreaded design and complete SMP support, so, if necessary, all your CPU cores will participate in the commands
|
|
processing.</span></li>
|
|
<li><span>Well documented.</span></li>
|
|
</ul>
|
|
<p>Interoperability between remote and local SCSI initiators (i.e. sd, st, etc.) is the additional issue that SCST is going to
|
|
address (it is not implemented yet). It is necessary, because local SCSI initiators can change the state of the
|
|
device, for example RESERVE the device, or some of its parameters and that could be done behind SCST, i.e. remote initiators
|
|
will not know about it, which could
|
|
lead to various problems, including data corruption. Thus, RESERVE/RELEASE commands, locally generated
|
|
UNIT ATTENTIONs, etc. should be intercepted and passed through SCST core.</p>
|
|
|
|
<p>You can find comparison of SCST with other SCSI targets on the <a href="comparison.html">Comparison</a> page.
|
|
Some highlights what it can mean for end users you can find on the <a href="http://iscsi-scst.sourceforge.net">iSCSI-SCST</a> page.
|
|
|
|
<h1>SCST core supports the following I/O modes</h1>
|
|
<ul>
|
|
<li><span>Pass-through mode with one to many relationship, i.e. when multiple initiators can
|
|
connect to the exported pass-through devices, for virtually all SCSI devices types: disks (type 0),
|
|
tapes (type 1), processors (type 3), CDROMs (type 5), MO disks (type 7), medium changers (type 8) and RAID
|
|
controllers (type 0xC). In this mode you can, for instance, share your parallel SCSI tape or SATA
|
|
DVD-RW device to your iSCSI network.</span></li>
|
|
<li><span>FILEIO mode, which allows to use files on file systems or block devices as virtual
|
|
remotely available SCSI disks or CDROMs with benefits of the Linux cache.</span></li>
|
|
<li><span>BLOCKIO mode, which performs direct block IO with a block device, bypassing
|
|
page-cache for all operations. This mode works well with high-end storage HBAs and for applications that
|
|
either do not need caching between application and disk or need the large block throughput.</span></li>
|
|
<li><span>User space mode using scst_user device handler, which allows to implement in the
|
|
user space high performance virtual SCSI devices. Comparing with fully in-kernel dev handlers
|
|
this mode has very low overhead (few %%).</span></li>
|
|
<li><span>Performance testing device handlers as well as NULLIO mode to provide
|
|
a way for direct performance measurements without overhead of actual data
|
|
transfers from/to underlying SCSI devices.
|
|
</span></li>
|
|
</ul>
|
|
|
|
<h1>Certification</h1>
|
|
|
|
<p>SCST core engine has passed VMware certification as part of
|
|
<a href="http://scalecomputing.com/products">Scale’s Intelligent Clustered Storage</a> technology developed by
|
|
<a href="http://scalecomputing.com">Scale Computing</a> and
|
|
<a href="http://www.vmware.com/resources/compatibility/search.php?action=search&deviceCategory=san&partnerId[]=123">storage arrays</a>
|
|
developed by <a href="http://www.open-e.com/">Open-E, Inc</a>.</p>
|
|
|
|
</div>
|
|
<div id="rightbar">
|
|
<h1>Documentation</h1>
|
|
<p><a href="scst_pg.html">HTML</a></p>
|
|
<p><a href="scst_pg.pdf">PDF</a></p>
|
|
<p><a href="http://iscsi-scst.sourceforge.net/iscsi-scst-howto.txt">HOWTO For iSCSI-SCST</a></p>
|
|
<p><a href="http://iscsi-scst.sourceforge.net/SCST_Gentoo_HOWTO.txt">Gentoo HOWTO For iSCSI-SCST</a></p>
|
|
<p><a href="http://alpinelinux.org/wiki/High_performance_SCST_iSCSI_Target_on_Linux_software_Raid" class="readmore">Alpine Linux HOWTO</a></p>
|
|
<p><a href="qla2x00t-howto.html">HOWTO For QLogic Target Driver</a></p>
|
|
<p><a href="http://lpfcxxxx.sourceforge.net/HOWTO.lpfc">HOWTO For Emulex lpfc Target Driver</a></p>
|
|
<p><a href="sgv_cache.html">SCST SGV Cache Description</a></p>
|
|
<h1>Articles</h1>
|
|
<p><a href="http://marcitland.blogspot.com/2011/03/accelerating-vdi-using-scst-and-ssds.html">Accelerating VDI Using SCST and SSDs</a>
|
|
by Marc Smith</p>
|
|
<h1>SCST 0.9.6 graphs</h1>
|
|
<p><a href="images/init_scst.png">init_scst</a></p>
|
|
<p><a href="images/scst_cmd_thread.png">scst_cmd_thread</a></p>
|
|
<p><a href="images/scst_mgmt_cmd_thread.png">scst_mgmt_cmd_thread</a></p>
|
|
<p><a href="images/scst_mgmt_thread.png">scst_mgmt_thread</a></p>
|
|
<p>all by Ming Zhang</p>
|
|
<h1>QUESTIONS</h1>
|
|
<p>If you have any questions you can ask them via<br><a href="http://lists.sourceforge.net/lists/listinfo/scst-devel">
|
|
scst-devel mailing list</a><br><br>
|
|
See <a href="http://sourceforge.net/mail/?group_id=110471">mailing lists page</a> for more info about SCST mailing
|
|
lists.</p>
|
|
<h1>SourceForge</h1>
|
|
<p><a href="http://sourceforge.net">
|
|
<img src="http://sourceforge.net/sflogo.php?group_id=110471&type=2" alt="SourceForge.net Logo" border="0">
|
|
</a></p>
|
|
<h1></h1>
|
|
<p><a href="http://validator.w3.org/check?uri=referer">
|
|
<img src="http://www.w3.org/Icons/valid-html401" alt="Valid HTML 4.01 Transitional" height="31" width="88"></a>
|
|
</p>
|
|
<p><a href="http://jigsaw.w3.org/css-validator/check/referer">
|
|
<img style="border:0;width:88px;height:31px" src="http://jigsaw.w3.org/css-validator/images/vcss" alt="Valid CSS!"></a>
|
|
</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<!-- footer starts here -->
|
|
<div id="footer">
|
|
<p>© Copyright 2004-2011<b><font class="names"> Vladislav Bolkhovitin/SCST Ltd & others.</font></b>
|
|
Design by: <b><font class="names">Daniel Fernandes</font></b> </p>
|
|
</div>
|
|
<!-- footer ends here -->
|
|
<!-- Piwik -->
|
|
<script type="text/javascript">
|
|
var pkBaseURL = (("https:" == document.location.protocol) ? "https://apps.sourceforge.net/piwik/scst/" : "http://apps.sourceforge.net/piwik/scst/");
|
|
document.write(unescape("%3Cscript src='" + pkBaseURL + "piwik.js' type='text/javascript'%3E%3C/script%3E"));
|
|
</script><script type="text/javascript">
|
|
piwik_action_name = '';
|
|
piwik_idsite = 1;
|
|
piwik_url = pkBaseURL + "piwik.php";
|
|
piwik_log(piwik_action_name, piwik_idsite, piwik_url);
|
|
</script>
|
|
<object><noscript><p><img src="http://apps.sourceforge.net/piwik/scst/piwik.php?idsite=1" alt="piwik"></p></noscript></object>
|
|
<!-- End Piwik Tag -->
|
|
</body>
|
|
</html>
|