6 :title: Storage: ZFS over ISCSI
9 Storage pool type: `zfs`
11 This backend accesses a remote machine having a ZFS pool as storage and an iSCSI
12 target implementation via `ssh`. For each guest disk it creates a ZVOL and,
13 exports it as iSCSI LUN. This LUN is used by {pve} for the guest disk.
15 The following iSCSI target implementations are supported:
22 NOTE: This plugin needs a ZFS capable remote storage appliance, you cannot use
23 it to create a ZFS Pool on a regular Storage Appliance/SAN
29 In order to use the ZFS over iSCSI plugin you need to configure the remote
30 machine (target) to accept `ssh` connections from the {pve} node. {pve} connects to the target for creating the ZVOLs and exporting them via iSCSI.
31 Authentication is done through a ssh-key (without password protection) stored in
32 `/etc/pve/priv/zfs/<target_ip>_id_rsa`
34 The following steps create a ssh-key and distribute it to the storage machine
38 mkdir /etc/pve/priv/zfs
39 ssh-keygen -f /etc/pve/priv/zfs/192.0.2.1_id_rsa
40 ssh-copy-id -i /etc/pve/priv/zfs/192.0.2.1_id_rsa.pub root@192.0.2.1
41 ssh -i /etc/pve/priv/zfs/192.0.2.1_id_rsa root@192.0.2.1
44 The backend supports the common storage properties `content`, `nodes`,
45 `disable`, and the following ZFS over ISCSI specific properties:
49 The ZFS pool/filesystem on the iSCSI target. All allocations are done within that
54 iSCSI portal (IP or DNS name with optional port).
62 The iSCSI target implementation used on the remote machine
66 target group for comstar views.
70 host group for comstar views.
74 target portal group for Linux LIO targets
78 disable write caching on the target
82 Set ZFS blocksize parameter.
86 Use ZFS thin-provisioning. A sparse volume is a volume whose
87 reservation is not equal to the volume size.
90 .Configuration Examples (`/etc/pve/storage.cfg`)
97 target iqn.2003-01.org.linux-iscsi.lio.x8664:sn.xxxxxxxxxxxx
104 target iqn.2010-08.org.illumos:02:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx:tank1
106 iscsiprovider comstar
112 target iqn.2007-09.jp.ne.peach.istgt:tank1
120 target iqn.2001-04.com.example:tank1
130 The ZFS over iSCSI plugin provides a shared storage, which is capable of
131 snapshots. You need to make sure that the ZFS appliance does not become a single
132 point of failure in your deployment.
134 .Storage features for backend `iscsi`
135 [width="100%",cols="m,m,3*d",options="header"]
136 |==============================================================================
137 |Content types |Image formats |Shared |Snapshots |Clones
138 |images |raw |yes |yes |no
139 |==============================================================================
146 * link:/wiki/Legacy:_ZFS_over_iSCSI[Legacy: ZFS over iSCSI]