X-Git-Url: https://git.proxmox.com/?p=pve-docs.git;a=blobdiff_plain;f=pve-storage-zfspool.adoc;h=366a1f32cbb98cd7a2207926d5cff99ac1057272;hp=dbdfb7de41290204d3946d16bec4fcfb1c25b70f;hb=cc38b9254cf54f33b3cd4c247ee273c1ddad146f;hpb=aa039b0f5a044a78ff175d8a70178d7b10895567 diff --git a/pve-storage-zfspool.adoc b/pve-storage-zfspool.adoc index dbdfb7d..366a1f3 100644 --- a/pve-storage-zfspool.adoc +++ b/pve-storage-zfspool.adoc @@ -1,11 +1,17 @@ +[[storage_zfspool]] Local ZFS Pool Backend ---------------------- +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 ~~~~~~~~~~~~~ @@ -26,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 @@ -34,6 +46,7 @@ zfspool: vmdata sparse ---- + File naming conventions ~~~~~~~~~~~~~~~~~~~~~~~ @@ -49,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. @@ -70,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[]