X-Git-Url: https://git.proxmox.com/?a=blobdiff_plain;f=pve-storage-zfspool.adoc;h=366a1f32cbb98cd7a2207926d5cff99ac1057272;hb=82f71eea81b5b1976560577bb743b667a2402afe;hp=aaf9e94c52fc51bb8b760367e7615f52d7d57183;hpb=fc3425bdf7c0fca3a2c25c9221a4a3abc3f6d295;p=pve-docs.git diff --git a/pve-storage-zfspool.adoc b/pve-storage-zfspool.adoc index aaf9e94..366a1f3 100644 --- a/pve-storage-zfspool.adoc +++ b/pve-storage-zfspool.adoc @@ -1,12 +1,17 @@ +[[storage_zfspool]] Local ZFS Pool Backend ---------------------- -include::attributes.txt[] +ifdef::wiki[] +:pve-toplevel: +:title: Storage: ZFS +endif::wiki[] Storage pool type: `zfspool` -This backend allows you to access local ZFS pools (or ZFS filesystems +This backend allows you to access local ZFS pools (or ZFS file systems inside such pools). + Configuration ~~~~~~~~~~~~~ @@ -27,7 +32,13 @@ sparse:: Use ZFS thin-provisioning. A sparse volume is a volume whose reservation is not equal to the volume size. -.Configuration Example ('/etc/pve/storage.cfg') +mountpoint:: + +The mount point of the ZFS pool/filesystem. Changing this does not +affect the `mountpoint` property of the dataset seen by `zfs`. +Defaults to `/`. + +.Configuration Example (`/etc/pve/storage.cfg`) ---- zfspool: vmdata pool tank/vmdata @@ -35,6 +46,7 @@ zfspool: vmdata sparse ---- + File naming conventions ~~~~~~~~~~~~~~~~~~~~~~~ @@ -50,7 +62,7 @@ This specifies the owner VM. ``:: -This scan be an arbitrary name (`ascii`) without white spaces. The +This can be an arbitrary name (`ascii`) without white space. The backend uses `disk[N]` as default, where `[N]` is replaced by an integer to make the name unique. @@ -71,17 +83,29 @@ on the parent dataset. |images rootdir |raw subvol |no |yes |yes |============================================================================== + Examples ~~~~~~~~ -It is recommended to create and extra ZFS filesystem to store your VM images: +It is recommended to create an extra ZFS file system to store your VM images: # zfs create tank/vmdata -To enable compression on that newly allocated filesystem: +To enable compression on that newly allocated file system: # zfs set compression=on tank/vmdata You can get a list of available ZFS filesystems with: # pvesm zfsscan + +ifdef::wiki[] + +See Also +~~~~~~~~ + +* link:/wiki/Storage[Storage] + +* link:/wiki/ZFS_on_Linux[ZFS on Linux] + +endif::wiki[]