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