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