LIO (SCSI target)
Page Module:Message box/ambox.css has no content.Page Template:Multiple issues/styles.css has no content.
This article has multiple issues. Please help improve it or discuss these issues on the talk page. (Learn how and when to remove these messages)
Page Module:Message box/ambox.css has no content.
|
Page Module:Infobox/styles.css has no content.
| LIO Target | |
|---|---|
| Lua error in package.lua at line 80: module 'Module:InfoboxImage/data' not found. LIO Linux SCSI Target | |
| [[Programmer|Original authorTemplate:Pluralize from text]] | Nicholas Bellinger Jerome Martin |
| [[Programmer|DeveloperTemplate:Pluralize from text]] | Datera, Inc. |
| Initial release | Script error: No such module "Date time". |
| Written in | C, Python |
| Operating system | Linux |
| Type | Block storage |
| License | GNU General Public License |
| Website | Script error: No such module "webarchive". |
| Repository | github |
Script error: No such module "Check for conflicting parameters".
The Linux-IO (LIO) is an open-source Small Computer System Interface (SCSI) target implementation included with the Linux kernel.[1]Template:Better source
Unlike initiators, which begin sessions, LIO functions as a target, presenting one or more Logical Unit Numbers (LUNs) to a SCSI initiator, receiving SCSI commands, and managing the input/output data transfers.[citation needed]
LIO supports a wide range of storage protocols and transport fabrics, including but not limited to Fibre Channel over Ethernet (FCoE), Fibre Channel, IEEE 1394 and iSCSI.[citation needed]
It is utilized in several Linux distributions and is a popular choice for cloud environments due to its integration with tools like QEMU/KVM, libvirt, and OpenStack.[citation needed]
The LIO project is maintained by Datera,[dubious – discuss] a Silicon Valley-based storage solutions provider. On January 15, 2011, LIO was merged into the Linux kernel mainline with version 2.6.38, which was officially released on March 14, 2011.[2][3] Subsequent versions of the Linux kernel have introduced additional fabric modules to expand its compatibility.[citation needed]
LIO competes with other SCSI target modules in the Linux ecosystem. The SCSI Target Framework (SCST)[4] is a prominent alternative for general SCSI target functionality, while for iSCSI-specific targets, the older iSCSI Enterprise Target (IET) and SCSI Target Framework (STGT) also have industry adoption.[5][6]
Background
The SCSI standard provides an extensible semantic abstraction for computer data storage devices, and is used with data storage systems. The SCSI T10 standards[7] define the commands[8] and protocols of the SCSI command processor (sent in SCSI CDBs), and the electrical and optical interfaces for various implementations.
A SCSI initiator is an endpoint that initiates a SCSI session. A SCSI target is the endpoint that waits for initiator commands and executes the required I/O data transfers. The SCSI target usually exports one or more LUNs for initiators to operate on.
The LIO Linux SCSI Target implements a generic SCSI target that provides remote access to most data storage device types over all prevalent storage fabrics and protocols. LIO neither directly accesses data nor does it directly communicate with applications.
Architecture

LIO implements a modular and extensible architecture around a parallelised SCSI command processing engine.[9]
The LIO SCSI target engine is independent of specific fabric modules or backstore types. Thus, LIO supports mixing and matching any number of fabrics and backstores at the same time. The LIO SCSI target engine implements a comprehensive SPC-3/SPC-4[10] feature set with support for high-end features, including SCSI-3/SCSI-4 Persistent Reservations (PRs), SCSI-4 Asymmetric Logical Unit Assignment (ALUA), VMware vSphere APIs for Array Integration (VAAI),[11] T10 DIF, etc.
LIO is configurable via a configfs-based[12] kernel API, and can be managed via a command-line interface and API (targetcli).
SCSI target
The concept of a SCSI target isn't restricted to physical devices on a SCSI bus, but instead provides a generalised model for all receivers on a logical SCSI fabric. This includes SCSI sessions across interconnects with no physical SCSI bus at all. Conceptually, the SCSI target provides a generic block storage service or server in this scenario.
Back-stores
Back-stores provide the SCSI target with generalised access to data storage devices by importing them via corresponding device drivers. Back-stores do not need to be physical SCSI devices.
The most important back-store media types are:
- Block: The block driver allows using raw Linux block devices as back-stores for export via LIO. This includes physical devices, such as HDDs, SSDs, CDs/DVDs, RAM disks, etc., and logical devices, such as software or hardware RAID volumes or LVM volumes.
- File: The file driver allows using files that can reside in any Linux file system or clustered file system as back-stores for export via LIO.
- Raw: The raw driver allows using unstructured memory as back-stores for export via LIO.
As a result, LIO provides a generalised model to export block storage.
Fabric modules
Fabric modules implement the front-end of the SCSI target by encapsulating and abstracting the properties of the various supported interconnect. The following fabric modules are available.
FCoE

The Fibre Channel over Ethernet (FCoE) fabric module allows the transport of Fibre Channel protocol (FCP) traffic across lossless Ethernet networks. The specification, supported by a large number of network and storage vendors, is part of the Technical Committee T11 FC-BB-5 standard.[13]
LIO supports all standard Ethernet NICs.
The FCoE fabric module was contributed by Cisco and Intel, and released with Linux 3.0 on July 21, 2011.[14]
Fibre Channel
Fibre Channel is a high-speed network technology primarily used for storage networking. It is standardized in the Technical Committee T11[15] of the InterNational Committee for Information Technology Standards (INCITS).
The QLogic Fibre Channel fabric module supports 4- and 8-gigabit speeds with the following HBAs:
- QLogic 2400 Series (QLx246x), 4GFC
- QLogic 2500 Series (QLE256x), 8GFC (fully qual'd)
The Fibre Channel fabric module[16] and low-level driver[17] (LLD) were released with Linux 3.5 on July 21, 2012.[18]
With Linux 3.9, the following QLogic HBAs and CNAs are also supported:
- QLogic 2600 Series (QLE266x), 16GFC, SR-IOV
- QLogic 8300 Series (QLE834x), 16GFS/10 GbE, PCIe Gen3 SR-IOV
- QLogic 8100 Series (QLE81xx), 8GFC/10 GbE, PCIe Gen2
This makes LIO the first open source target to support 16-gigabit Fibre Channel.
IEEE 1394

The FireWire SBP-2 fabric module enables Linux to export local storage devices via IEEE 1394, so that other systems can mount them as an ordinary IEEE 1394 storage device.
IEEE 1394 is a serial-bus interface standard for high-speed communications and isochronous real-time data transfer. It was developed by Apple as "FireWire" in the late 1980s and early 1990s, and Macintosh computers have supported "FireWire target disk mode" since 1999.[19]
The FireWire SBP-2 fabric module was released with Linux 3.5 on July 21, 2012.[18][20]
iSCSI
The Internet Small Computer System Interface (iSCSI) fabric module allows the transport of SCSI traffic across standard IP networks.
By carrying SCSI sessions across IP networks, iSCSI is used to facilitate data transfers over intranets and manage storage over long distances. iSCSI can be used to transmit data over local area networks (LANs), wide area networks (WANs), or the Internet, and can enable location-independent and location-transparent data storage and retrieval.
The LIO iSCSI fabric module also implements a number of advanced iSCSI features that increase performance and resiliency, such as Multiple Connections per Session (MC/S) and Error Recovery Levels 0-2 (ERL=0,1,2).
LIO supports all standard Ethernet NICs.
The iSCSI fabric module was released with Linux 3.1 on October 24, 2011.[21]
iSER
Networks supporting remote direct memory access (RDMA) can use the iSCSI Extensions for RDMA (iSER) fabric module to transport iSCSI traffic. iSER permits data to be transferred directly into and out of remote SCSI computer memory buffers without intermediate data copies (direct data placement or DDP) by using RDMA.[22] RDMA is supported on InfiniBand networks, on Ethernet with data center bridging (DCB) networks via RDMA over Converged Ethernet (RoCE), and on standard Ethernet networks with iWARP enhanced TCP offload engine controllers.
The iSER fabric module was developed together by Datera and Mellanox Technologies, and first released with Linux 3.10 on June 30, 2013.[23]
SRP
The SCSI RDMA Protocol (SRP) fabric module allows the transport of SCSI traffic across RDMA (see above) networks. As of 2013, SRP was more widely used than iSER, although it is more limited, as SCSI is only a peer-to-peer protocol, whereas iSCSI is fully routable. The SRP fabric module supports the following Mellanox host channel adapters (HCAs):
- Mellanox ConnectX-2 VPI PCIe Gen2 HCAs (x8 lanes), single/dual-port QDR 40 Gbit/s
- Mellanox ConnectX-3 VPI PCIe Gen3 HCAs (x8 lanes), single/dual-port FDR 56 Gbit/s
- Mellanox ConnectX-IB PCIe Gen3 HCAs (x16 lanes), single/dual-port FDR 56 Gbit/s
The SRP fabric module was released with Linux 3.3 on March 18, 2012.[24]
In 2012, c't magazine measured almost 5000 MB/s throughput with LIO SRP Target over one Mellanox ConnectX-3 port in 56 Gbit/s FDR mode on a Sandy Bridge PCI Express 3.0 system with four Fusion-IO ioDrive PCI Express flash memory cards.
USB
The USB Gadget fabric module enables Linux to export local storage devices via the Universal Serial Bus (USB), so that other systems can mount them as an ordinary storage device.
USB was designed in the mid-1990s to standardize the connection of computer peripherals, and has also become common for data storage devices.
The USB Gadget fabric module was released with Linux 3.5 on July 21, 2012.[25]
Targetcli
targetcli is a user space single-node management command line interface (CLI) for LIO.[26] It supports all fabric modules and is based on a modular, extensible architecture, with plug-in modules for additional fabric modules or functionality.
targetcli provides a CLI that uses an underlying generic target library through a well-defined API. Thus the CLI can easily be replaced or complemented by a UI with other metaphors, such as a GUI.
targetcli is implemented in Python and consists of three main modules:
- the underlying rtslib and API.[27]
- the configshell, which encapsulates the fabric-specific attributes in corresponding 'spec' files.
- the targetcli shell itself.
Detailed instructions on how to set up LIO targets can be found on the LIO wiki.[26]
Linux distributions
targetcli and LIO are included in most Linux distributions per default. Here is an overview of the most popular ones, together with the initial inclusion dates:
| Distribution | Version[a] | Release | Archive | Installation | Source git | Documentation |
|---|---|---|---|---|---|---|
| Alpine Linux | 2.5 | 2011-11-07 | Alpine Linux mirror Script error: No such module "webarchive". | apk add targetcli-fb
|
targetcli-fb.git | How-to |
| CentOS | 6.2 | 2011-12-20 | CentOS mirror | su -c 'yum install fcoe-target-utils'
|
targetcli-fb.git | Tech Notes |
| Debian | 7.0 ("wheezy") | 2013-05-04 | Debian pool | su -c 'apt-get install targetcli'
|
targetcli.git | Script error: No such module "webarchive". |
| Fedora | 16 | 2011-11-08 | Fedora Rawhide | su -c 'yum install targetcli'
|
targetcli-fb.git | Target Wiki |
| openSUSE | 12.1 | 2011-11-08 | Requires manual installation from Datera targetcli.git repos. | |||
| RHEL[b] | 6.2 | 2011-11-16 | Fedora Rawhide | su -c 'yum install fcoe-target-utils'
|
targetcli-fb.git | Tech Notes |
| Scientific Linux | 6.2 | 2012-02-16 | SL Mirror | su -c 'yum install fcoe-target-utils'
|
targetcli-fb.git | Tech Notes |
| SLES | 11 SP3 MR | 2013-12 | - | su -c 'zypper in targetcli'
|
targetcli.git | Script error: No such module "webarchive". |
| Ubuntu | 12.04 LTS (precise) | 2012-04-26 | Ubuntu universe | sudo apt-get install targetcli
|
targetcli.git | Script error: No such module "webarchive". |
See also
Page Template:Div col/styles.css has no content.
- The SCST Linux SCSI target software stack
- Fibre Channel
- Fibre Channel over Ethernet (FCoE)
- IEEE 1394 / Firewire
- InfiniBand
- iSCSI
- iSCSI Extensions for RDMA (iSER)
- SCSI RDMA Protocol (SRP)
- USB
Notes
Page Template:Reflist/styles.css has no content.
References
Page Template:Reflist/styles.css has no content.
- ^ Page Module:Citation/CS1/styles.css has no content."LIO". Linux-IO, the Linux SCSI Target wiki. 2016-03-12. Archived from the original on 2022-08-20.
- ^ Page Module:Citation/CS1/styles.css has no content.Linus Torvalds (2011-01-14). "Trivial merge". Kernel.org. Retrieved 2019-09-28.
- ^ Page Module:Citation/CS1/styles.css has no content.Thorsten Leemhuis (2011-03-02). "Kernel Log: Coming in 2.6.38 (Part 4) - Storage". Heise Online.
- ^ Page Module:Citation/CS1/styles.css has no content."A tale of two SCSI targets". Lwn.net. Archived from the original on 2014-02-02. Retrieved 2014-01-20.
- ^ Page Module:Citation/CS1/styles.css has no content.Haas, Florian (May 2012). "Replicate Everything! Highly Available iSCSI Storage with DRBD and Pacemaker". Linux Journal. Retrieved 2019-09-28.
{{cite web}}: CS1 maint: deprecated archival service (link) - ^ Page Module:Citation/CS1/styles.css has no content.Bolkhovitin, Vladislav (2018-04-11). "SCST vs STGT". Generic SCSI Target Subsystem for Linux. Retrieved 2019-04-01.
- ^ Page Module:Citation/CS1/styles.css has no content.Technical Committee T10. "SCSI Storage Interfaces". t10.org. Retrieved 2012-12-24.
{{cite web}}: CS1 maint: numeric names: authors list (link) - ^ Page Module:Citation/CS1/styles.css has no content.SCSI Commands Reference Manual (PDF). 100293068, Rev. C. Scotts Valley: Seagate Technology. April 2010. Archived from the original (PDF) on 2012-07-31. Retrieved 2012-12-25.
- ^ Page Module:Citation/CS1/styles.css has no content.Bellinger, Nicholas (2009). Current Status and Future of iSCSI on the Linux platform (PDF). Linux Plumbers Conference.
- ^ Page Module:Citation/CS1/styles.css has no content.Ralph Weber (2011-01-17). "SCSI Primary Commands - 4 (SPC-4)". t10.org. Retrieved 2011-03-07.
- ^ Page Module:Citation/CS1/styles.css has no content."vStorage APIs for Array Integration". Linux-IO, the Linux SCSI Target wiki. 2015-08-07. Archived from the original on 2022-08-20.
- ^ Page Module:Citation/CS1/styles.css has no content.Jonathan Corbet (2005-08-24). "Configfs - an introduction". lwn.net. Retrieved 2011-03-07.
- ^ Page Module:Citation/CS1/styles.css has no content."Fibre Channel: Backbone - 5 revision 2.00" (PDF). American National Standard for Information Technology International Committee for Information Technology Standards Technical Group T11. June 4, 2009. Retrieved 2011-05-05.
- ^ Page Module:Citation/CS1/styles.css has no content.Linus Torvalds (2011-04-18). "[SCSI] tcm_fc: Adding FC_FC4 provider (tcm_fc) for FCoE target (TCM - target core) support". Kernel.org. Retrieved 2019-09-28.
- ^ Page Module:Citation/CS1/styles.css has no content."T11 Home Page". t11.org. Retrieved 2012-12-25.
- ^ Page Module:Citation/CS1/styles.css has no content.Linus Torvalds (2012-05-15). "[SCSI] tcm_qla2xxx: Add >= 24xx series fabric module for target-core". Kernel.org. Retrieved 2019-09-28.
- ^ Page Module:Citation/CS1/styles.css has no content.Linus Torvalds (2012-05-15). "[SCSI] qla2xxx: Add LLD target-mode infrastructure for >= 24xx series". Kernel.org. Retrieved 2019-09-28.
- ^ a b Page Module:Citation/CS1/styles.css has no content.Thorsten Leemhuis (2012-07-03). "Kernel Log: Coming in 3.5 (Part 2) - Filesystems and storage". Heise Online. Retrieved 2013-01-14.
- ^ Page Module:Citation/CS1/styles.css has no content."How to use and troubleshoot FireWire target disk mode". apple.com. Retrieved 2012-12-24.
- ^ Page Module:Citation/CS1/styles.css has no content.Linus Torvalds (2012-04-15). "sbp-target: Initial merge of firewire/ieee-1394 target mode support". Kernel.org. Retrieved 2019-09-28.
- ^ Page Module:Citation/CS1/styles.css has no content.Linus Torvalds (2011-07-27). "iSCSI merge". Kernel.org. Retrieved 2019-09-28.
- ^ Template:IETF RFC
- ^ Page Module:Citation/CS1/styles.css has no content.Linus Torvalds (2013-04-30). "Merge branch 'for-next-merge'". Kernel.org. Retrieved 2019-09-28.
- ^ Page Module:Citation/CS1/styles.css has no content.Linus Torvalds (2012-01-18). "InfiniBand/SRP merge". Kernel.org. Retrieved 2019-09-28.
- ^ Page Module:Citation/CS1/styles.css has no content."Merge branch 'usb-target-merge'". Kernel.org. Retrieved 2019-09-28.
- ^ a b Page Module:Citation/CS1/styles.css has no content."Targetcli". Linux-IO, the Linux SCSI Target wiki. 2012-12-09. Archived from the original on 2013-03-02. Retrieved 2012-12-25.
- ^ Page Module:Citation/CS1/styles.css has no content.Jerome Martin (2011-08-03). "Package rtslib". daterainc.com. Retrieved 2012-12-25.
- ^ Page Module:Citation/CS1/styles.css has no content."Chapter 6. Storage". Access.redhat.com. Retrieved 2014-01-20.
External links
- Script error: No such module "webarchive".
- Datera website
| Release | Details | 2011 | 2012 | 2013 | 2014 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
| 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | ||||||||||
| 4.x | Version | 4.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Feature | Target Core | Loopback | FCoE | iSCSI | Perf | SRP |
CM WQ | FC USB 1393 |
vHost | Perf | Misc | 16 GFC | iSER | Misc | VAAI | Misc | DIF Ref's NPIV |
iSER DIF | |||||||||||||||||||||||||||||||||||||||
| Linux | 2.6.38 | 2.6.39 | 3.0 | 3.1 | 3.2 | 3.3 | 3.4 | 3.5 | 3.6 | 3.7 | 3.8 | 3.9 | 3.10 | 3.11 | 3.12 | 3.13 | 3.14 | 3.15 | |||||||||||||||||||||||||||||||||||||||
Template:Navboxes bottom Lua error in package.lua at line 80: module 'Module:Navbox/configuration' not found. Lua error in package.lua at line 80: module 'Module:Navbox/configuration' not found.