improve docs about default storage configuration

[pve-docs.git] / pvesm.adoc

diff --git a/pvesm.adoc b/pvesm.adoc
index bbdec4730f23f6f6a110c1362b643ed736552f16..5f8020e895a4ebdd5aee5a35cfaee4004d4f421d 100644 (file)
--- a/pvesm.adoc
+++ b/pvesm.adoc
@@ -102,6 +102,11 @@ resizing the VMs filesystems.
 All storage types which have the 'Snapshots' feature also support thin
 provisioning.
 
+CAUTION: If a storage runs full, all guests using volumes on that
+storage receives IO error. This can cause file system inconsistencies
+and may corrupt your data. So it is advisable to avoid
+over-provisioning of your storage resources, or carefully observe
+free space to avoid such conditions.
 
 Storage Configuration
 ---------------------
@@ -129,24 +134,33 @@ Each storage pool has a `<type>`, and is uniquely identified by its `<STORAGE_ID
        ...
 ----
 
-NOTE: There is one special local storage pool named `local`. It refers to
-the directory '/var/lib/vz' and is automatically generated at installation
-time.
-
 The `<type>: <STORAGE_ID>` line starts the pool definition, which is then
 followed by a list of properties. Most properties have values, but some of
 them come with reasonable default. In that case you can omit the value.
 
+To be more specific, take a look at the default storage configuration
+after installation. It contains one special local storage pool named
+`local`, which refers to the directory '/var/lib/vz' and is always
+available. The {pve} installer creates additional storage entries
+depending on the storage type chosen at installation time.
+
 .Default storage configuration ('/etc/pve/storage.cfg')
 ----
 dir: local
        path /var/lib/vz
        content iso,vztmpl,backup
 
+# default image store on LVM based installation
 lvmthin: local-lvm
        thinpool data
        vgname pve
        content rootdir,images
+
+# default image store on ZFS based installation
+zfspool: local-zfs
+       pool rpool/data
+       sparse
+       content images,rootdir
 ----
 
 Common Storage Properties