pve-docs/pve-storage-iscsidirect.adoc

[[storage_iscsidirect]]
User Mode iSCSI Backend
-----------------------
ifdef::wiki[]
:pve-toplevel:
:title: Storage: User Mode iSCSI
endif::wiki[]

Storage pool type: `iscsidirect`

This backend provides basically the same functionality as the Open-iSCSI backed,
but uses a user-level library to implement it. You need to install the
`libiscsi-bin` package in order to use this backend.

It should be noted that there are no kernel drivers involved, so this
can be viewed as performance optimization. But this comes with the
drawback that you cannot use LVM on top of such iSCSI LUN. So you need
to manage all space allocations at the storage server side.

Configuration
~~~~~~~~~~~~~

The user mode iSCSI backend uses the same configuration options as the
Open-iSCSI backed.

.Configuration Example (`/etc/pve/storage.cfg`)
----
iscsidirect: faststore
     portal 10.10.10.1
     target iqn.2006-01.openfiler.com:tsn.dcb5aaaddd
----

Storage Features
~~~~~~~~~~~~~~~~

NOTE: This backend works with VMs only. Containers cannot use this
driver.

.Storage features for backend `iscsidirect`
[width="100%",cols="m,m,3*d",options="header"]
|==============================================================================
|Content types  |Image formats  |Shared |Snapshots |Clones
|images         |raw            |yes    |no        |no
|==============================================================================

ifdef::wiki[]

See Also
~~~~~~~~

* link:/wiki/Storage[Storage]

endif::wiki[]
add references to storage docs so that they can be easily referenced, by the WebUI for example Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com> 2018-07-06 13:30:33 +02:00			`[[storage_iscsidirect]]`
import storage docs 2016-01-05 10:02:14 +01:00			`User Mode iSCSI Backend`
			`-----------------------`
mark toplevel docs 2016-10-08 17:22:48 +02:00			`ifdef::wiki[]`
			`:pve-toplevel:`
add correct wiki titles 2016-10-10 08:55:17 +02:00			`:title: Storage: User Mode iSCSI`
mark toplevel docs 2016-10-08 17:22:48 +02:00			`endif::wiki[]`

import storage docs 2016-01-05 10:02:14 +01:00			Storage pool type: `iscsidirect`

storage: iscsi direct: update information about packages As reported in the community forum [0], libiscsi-bin is required. The library package on Bullseye would be libiscsi7, but there is no real need to mention the package explicitly, because it is a dependency of both, libiscsi-bin and pve-qemu-kvm. [0]: https://forum.proxmox.com/threads/119369 Signed-off-by: Fiona Ebner <f.ebner@proxmox.com> 2022-12-12 11:30:01 +01:00			`This backend provides basically the same functionality as the Open-iSCSI backed,`
			`but uses a user-level library to implement it. You need to install the`
			`libiscsi-bin` package in order to use this backend.
import storage docs 2016-01-05 10:02:14 +01:00
			`It should be noted that there are no kernel drivers involved, so this`
			`can be viewed as performance optimization. But this comes with the`
			`drawback that you cannot use LVM on top of such iSCSI LUN. So you need`
			`to manage all space allocations at the storage server side.`

			`Configuration`
			`~~~~~~~~~~~~~`

			`The user mode iSCSI backend uses the same configuration options as the`
			`Open-iSCSI backed.`

formatting cleanup reformat most existing 'text' as either `text` or ``text'' reformat most existing "text" as either ``text'' or `text` reformat 'x' as `x` harmonize bullet list syntax to use '*' instead of '-' 2016-09-27 10:58:50 +02:00			.Configuration Example (`/etc/pve/storage.cfg`)
import storage docs 2016-01-05 10:02:14 +01:00			`----`
			`iscsidirect: faststore`
			`portal 10.10.10.1`
			`target iqn.2006-01.openfiler.com:tsn.dcb5aaaddd`
			`----`

			`Storage Features`
			`~~~~~~~~~~~~~~~~`

			`NOTE: This backend works with VMs only. Containers cannot use this`
			`driver.`

			.Storage features for backend `iscsidirect`
			`[width="100%",cols="m,m,3*d",options="header"]`
			`\|==============================================================================`
			`\|Content types \|Image formats \|Shared \|Snapshots \|Clones`
			`\|images \|raw \|yes \|no \|no`
			`\|==============================================================================`

add wiki interlnal links 2016-05-04 07:22:27 +02:00			`ifdef::wiki[]`

			`See Also`
			`~~~~~~~~`

fix wiki links 2016-08-12 10:51:16 +02:00			`* link:/wiki/Storage[Storage]`
add wiki interlnal links 2016-05-04 07:22:27 +02:00
			`endif::wiki[]`