formatting cleanup
[pve-docs.git] / pve-storage-iscsidirect.adoc
1 User Mode iSCSI Backend
2 -----------------------
3 include::attributes.txt[]
4
5 Storage pool type: `iscsidirect`
6
7 This backend provides basically the same functionality as the
8 Open-iSCSI backed, but uses a user-level library (package `libiscsi2`)
9 to implement it.
10
11 It should be noted that there are no kernel drivers involved, so this
12 can be viewed as performance optimization. But this comes with the
13 drawback that you cannot use LVM on top of such iSCSI LUN. So you need
14 to manage all space allocations at the storage server side.
15
16 Configuration
17 ~~~~~~~~~~~~~
18
19 The user mode iSCSI backend uses the same configuration options as the
20 Open-iSCSI backed.
21
22 .Configuration Example (`/etc/pve/storage.cfg`)
23 ----
24 iscsidirect: faststore
25      portal 10.10.10.1
26      target iqn.2006-01.openfiler.com:tsn.dcb5aaaddd
27 ----
28
29 Storage Features
30 ~~~~~~~~~~~~~~~~
31
32 NOTE: This backend works with VMs only. Containers cannot use this
33 driver.
34
35 .Storage features for backend `iscsidirect`
36 [width="100%",cols="m,m,3*d",options="header"]
37 |==============================================================================
38 |Content types  |Image formats  |Shared |Snapshots |Clones
39 |images         |raw            |yes    |no        |no
40 |==============================================================================
41
42 ifdef::wiki[]
43
44 See Also
45 ~~~~~~~~
46
47 * link:/wiki/Storage[Storage]
48
49 endif::wiki[]
50