]> git.proxmox.com Git - pve-docs.git/blobdiff - pvesm.adoc
config: remove reference to preceeding / from content-dirs
[pve-docs.git] / pvesm.adoc
index 5340c3dc5395120012fa0e3d5113d5063303615f..6ade1a4c86fb0a6d28dc4f1a15f89eba4b7aba28 100644 (file)
@@ -65,13 +65,15 @@ data to different nodes.
 
 
 .Available storage types
-[width="100%",cols="<d,1*m,4*d",options="header"]
+[width="100%",cols="<2d,1*m,4*d",options="header"]
 |===========================================================
 |Description    |PVE type    |Level |Shared|Snapshots|Stable
 |ZFS (local)    |zfspool     |file  |no    |yes      |yes
 |Directory      |dir         |file  |no    |no^1^    |yes
+|BTRFS          |btrfs       |file  |no    |yes      |technology preview
 |NFS            |nfs         |file  |yes   |no^1^    |yes
 |CIFS           |cifs        |file  |yes   |no^1^    |yes
+|Proxmox Backup |pbs         |both  |yes   |n/a      |yes
 |GlusterFS      |glusterfs   |file  |yes   |no^1^    |yes
 |CephFS         |cephfs      |file  |yes   |yes      |yes
 |LVM            |lvm         |block |no^2^ |no       |yes
@@ -80,18 +82,18 @@ data to different nodes.
 |iSCSI/libiscsi |iscsidirect |block |yes   |no       |yes
 |Ceph/RBD       |rbd         |block |yes   |yes      |yes
 |ZFS over iSCSI |zfs         |block |yes   |yes      |yes
-|=========================================================
+|===========================================================
 
 ^1^: On file based storages, snapshots are possible with the 'qcow2' format.
 
-^2^: It is possible to use LVM on top of an iSCSI storage. That way
-you get a `shared` LVM storage.
+^2^: It is possible to use LVM on top of an iSCSI or FC-based storage.
+That way you get a `shared` LVM storage.
 
 
 Thin Provisioning
 ~~~~~~~~~~~~~~~~~
 
-A number of storages, and the Qemu image format `qcow2`, support 'thin
+A number of storages, and the QEMU image format `qcow2`, support 'thin
 provisioning'.  With thin provisioning activated, only the blocks that
 the guest system actually use will be written to the storage.
 
@@ -193,7 +195,7 @@ this property to select what this storage is used for.
 
 images:::
 
-KVM-Qemu VM images.
+QEMU/KVM VM images.
 
 rootdir:::
 
@@ -225,12 +227,24 @@ You can use this flag to disable the storage completely.
 
 maxfiles::
 
-Maximum number of backup files per VM. Use `0` for unlimited.
+Deprecated, please use `prune-backups` instead. Maximum number of backup files
+per VM. Use `0` for unlimited.
+
+prune-backups::
+
+Retention options for backups. For details, see
+xref:vzdump_retention[Backup Retention].
 
 format::
 
 Default image format (`raw|qcow2|vmdk`)
 
+preallocation::
+
+Preallocation mode (`off|metadata|falloc|full`) for `raw` and `qcow2` images on
+file-based storages. The default is `metadata`, which is treated like `off` for
+`raw` images. When using network storages in combination with large `qcow2`
+images, using `off` can help to avoid timeouts.
 
 WARNING: It is not advisable to use the same storage pool on different
 {pve} clusters. Some storage operation need exclusive access to the
@@ -357,6 +371,14 @@ Show file system path for a volume
 
  pvesm path <VOLUME_ID>
 
+Exporting the volume `local:103/vm-103-disk-0.qcow2` to the file `target`.
+This is mostly used internally with `pvesm import`.
+The stream format qcow2+size is different to the qcow2 format.
+Consequently, the exported file cannot simply be attached to a VM.
+This also holds for the other formats.
+
+ pvesm export local:103/vm-103-disk-0.qcow2 qcow2+size target --with-snapshots 1
+
 ifdef::wiki[]
 
 See Also
@@ -378,6 +400,8 @@ See Also
 
 * link:/wiki/Storage:_CIFS[Storage: CIFS]
 
+* link:/wiki/Storage:_Proxmox_Backup_Server[Storage: Proxmox Backup Server]
+
 * link:/wiki/Storage:_RBD[Storage: RBD]
 
 * link:/wiki/Storage:_CephFS[Storage: CephFS]
@@ -398,6 +422,8 @@ include::pve-storage-nfs.adoc[]
 
 include::pve-storage-cifs.adoc[]
 
+include::pve-storage-pbs.adoc[]
+
 include::pve-storage-glusterfs.adoc[]
 
 include::pve-storage-zfspool.adoc[]
@@ -414,6 +440,9 @@ include::pve-storage-rbd.adoc[]
 
 include::pve-storage-cephfs.adoc[]
 
+include::pve-storage-btrfs.adoc[]
+
+include::pve-storage-zfs.adoc[]
 
 
 ifdef::manvolnum[]