X-Git-Url: https://git.proxmox.com/?a=blobdiff_plain;f=pve-storage-dir.adoc;h=4eb8dcd6e80f22fa7daa4e1f351a09b3e49e1b78;hb=58e695ca6a2aa41b88ade5ea725b28f30dda405e;hp=a5084f88cff70851bb1513648986c586be62f5e6;hpb=b2f242abe4c50227f5610767e6fcaa40654c2b88;p=pve-docs.git diff --git a/pve-storage-dir.adoc b/pve-storage-dir.adoc index a5084f8..4eb8dcd 100644 --- a/pve-storage-dir.adoc +++ b/pve-storage-dir.adoc @@ -1,6 +1,6 @@ +[[storage_directory]] Directory Backend ----------------- -include::attributes.txt[] ifdef::wiki[] :pve-toplevel: :title: Storage: Directory @@ -39,28 +39,40 @@ storage backends. |ISO images |`template/iso/` |Container templates |`template/cache/` |Backup files |`dump/` +|Snippets |`snippets/` |=========================================================== Configuration ~~~~~~~~~~~~~ -This backend supports all common storage properties, and adds an -additional property called `path` to specify the directory. This -needs to be an absolute file system path. +This backend supports all common storage properties, and adds two +additional properties. The `path` property is used to specify the +directory. This needs to be an absolute file system path. + +The optional `content-dirs` property allows for the default layout +to be changed. It consists of a comma-separated list of identifiers +in the following format: + + vtype=path + +Where `vtype` is one of the allowed content types for the storage, and +`path` is a path relative to the mountpoint of the storage, preceded +with /. .Configuration Example (`/etc/pve/storage.cfg`) ---- dir: backup path /mnt/backup content backup - maxfiles 7 + prune-backups keep-last=7 + max-protected-backups 3 + content-dirs backup=/custom/backup/dir ---- -Above configuration defines a storage pool called `backup`. That pool -can be used to store up to 7 backups (`maxfiles 7`) per VM. The real -path for the backup files is `/mnt/backup/dump/...`. - +The above configuration defines a storage pool called `backup`. That pool can be +used to store up to 7 regular backups (`keep-last=7`) and 3 protected backups +per VM. The real path for the backup files is `/mnt/backup/custom/backup/dir/...`. File naming conventions ~~~~~~~~~~~~~~~~~~~~~~~ @@ -107,8 +119,8 @@ feature to create clones. .Storage features for backend `dir` [width="100%",cols="m,m,3*d",options="header"] |============================================================================== -|Content types |Image formats |Shared |Snapshots |Clones -|images rootdir vztempl iso backup |raw qcow2 vmdk subvol |no |qcow2 |qcow2 +|Content types |Image formats |Shared |Snapshots |Clones +|images rootdir vztmpl iso backup snippets |raw qcow2 vmdk subvol |no |qcow2 |qcow2 |==============================================================================