]> git.proxmox.com Git - pve-docs.git/blame - pve-storage-iscsi.adoc
storage: iscsi: don't use links in headers
[pve-docs.git] / pve-storage-iscsi.adoc
CommitLineData
12eb9705
TL
1Open-iSCSI initiator
2--------------------
5f09af76
DM
3ifdef::wiki[]
4:pve-toplevel:
cb84ed18 5:title: Storage: iSCSI
5f09af76
DM
6endif::wiki[]
7
aa039b0f
DM
8Storage pool type: `iscsi`
9
10iSCSI is a widely employed technology used to connect to storage
11servers. Almost all storage vendors support iSCSI. There are also open
12source iSCSI target solutions available,
13e.g. http://www.openmediavault.org/[OpenMediaVault], which is based on
14Debian.
15
12eb9705
TL
16To use this backend, you need to install the
17http://www.open-iscsi.org/[Open-iSCSI] (`open-iscsi`) package. This is a
18standard Debian package, but it is not installed by default to save
19resources.
aa039b0f
DM
20
21 # apt-get install open-iscsi
22
8c1189b6 23Low-level iscsi management task can be done using the `iscsiadm` tool.
aa039b0f
DM
24
25
26Configuration
27~~~~~~~~~~~~~
28
29The backend supports the common storage properties `content`, `nodes`,
30`disable`, and the following iSCSI specific properties:
31
32portal::
33
34iSCSI portal (IP or DNS name with optional port).
35
36target::
37
38iSCSI target.
39
40
8c1189b6 41.Configuration Example (`/etc/pve/storage.cfg`)
aa039b0f
DM
42----
43iscsi: mynas
44 portal 10.10.10.1
45 target iqn.2006-01.openfiler.com:tsn.dcb5aaaddd
46 content none
47----
48
49TIP: If you want to use LVM on top of iSCSI, it make sense to set
50`content none`. That way it is not possible to create VMs using iSCSI
51LUNs directly.
52
5eba0743 53
aa039b0f
DM
54File naming conventions
55~~~~~~~~~~~~~~~~~~~~~~~
56
57The iSCSI protocol does not define an interface to allocate or delete
58data. Instead, that needs to be done on the target side and is vendor
59specific. The target simply exports them as numbered LUNs. So {pve}
60iSCSI volume names just encodes some information about the LUN as seen
61by the linux kernel.
62
63
64Storage Features
65~~~~~~~~~~~~~~~~
66
67iSCSI is a block level type storage, and provides no management
68interface. So it is usually best to export one big LUN, and setup LVM
69on top of that LUN. You can then use the LVM plugin to manage the
70storage on that iSCSI LUN.
71
72.Storage features for backend `iscsi`
73[width="100%",cols="m,m,3*d",options="header"]
74|==============================================================================
75|Content types |Image formats |Shared |Snapshots |Clones
76|images none |raw |yes |no |no
77|==============================================================================
78
79
80Examples
81~~~~~~~~
82
83Scan a remote iSCSI portal, and returns a list of possible targets:
84
85 pvesm iscsiscan -portal <HOST[:PORT]>
86
deb4673f
DM
87ifdef::wiki[]
88
89See Also
90~~~~~~~~
91
f532afb7 92* link:/wiki/Storage[Storage]
deb4673f
DM
93
94endif::wiki[]
95
aa039b0f 96