X-Git-Url: https://git.proxmox.com/?p=pve-docs.git;a=blobdiff_plain;f=pve-storage-dir.adoc;h=090a44b2ee62bb3f5707a001d632c346d55ae5a6;hp=d8bdb53f8b012c40725ea24789ee62521d538616;hb=dd1aa0e01624f5927fb65143c9a070672ccbeb92;hpb=fc3425bdf7c0fca3a2c25c9221a4a3abc3f6d295 diff --git a/pve-storage-dir.adoc b/pve-storage-dir.adoc index d8bdb53..090a44b 100644 --- a/pve-storage-dir.adoc +++ b/pve-storage-dir.adoc @@ -1,6 +1,10 @@ +[[storage_directory]] Directory Backend ----------------- -include::attributes.txt[] +ifdef::wiki[] +:pve-toplevel: +:title: Storage: Directory +endif::wiki[] Storage pool type: `dir` @@ -9,7 +13,7 @@ storage. A directory is a file level storage, so you can store any content type like virtual disk images, containers, templates, ISO images or backup files. -NOTE: You can mount additional storages via standard linux '/etc/fstab', +NOTE: You can mount additional storages via standard linux `/etc/fstab`, and then define a directory storage for that mount point. This way you can use any file system supported by Linux. @@ -31,12 +35,14 @@ storage backends. [width="100%",cols="d,m",options="header"] |=========================================================== |Content type |Subdir -|VM images |images// -|ISO images |template/iso/ -|Container templates |template/cache -|Backup files |dump/ +|VM images |`images//` +|ISO images |`template/iso/` +|Container templates |`template/cache/` +|Backup files |`dump/` +|Snippets |`snippets/` |=========================================================== + Configuration ~~~~~~~~~~~~~ @@ -44,7 +50,7 @@ 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. -.Configuration Example ('/etc/pve/storage.cfg') +.Configuration Example (`/etc/pve/storage.cfg`) ---- dir: backup path /mnt/backup @@ -54,7 +60,7 @@ dir: backup 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/...'. +path for the backup files is `/mnt/backup/dump/...`. File naming conventions @@ -70,16 +76,16 @@ This specifies the owner VM. ``:: -This can 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. ``:: -Species the image format (`raw|qcow2|vmdk`). +Specifies the image format (`raw|qcow2|vmdk`). When you create a VM template, all VM images are renamed to indicate -that they are now read-only, and can be uses as a base image for clones: +that they are now read-only, and can be used as a base image for clones: base--. @@ -88,6 +94,7 @@ important that those files are read-only, and never get modified. The backend changes the access mode to `0444`, and sets the immutable flag (`chattr +i`) if the storage supports that. + Storage Features ~~~~~~~~~~~~~~~~ @@ -101,8 +108,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 |============================================================================== @@ -113,7 +120,7 @@ Please use the following command to allocate a 4GB image on storage `local`: # pvesm alloc local 100 vm-100-disk10.raw 4G Formatting '/var/lib/vz/images/100/vm-100-disk10.raw', fmt=raw size=4294967296 - sucessfuly created 'local:100/vm-100-disk10.raw' + successfully created 'local:100/vm-100-disk10.raw' NOTE: The image name must conform to above naming conventions. @@ -126,3 +133,14 @@ And you can remove the image with: # pvesm free local:100/vm-100-disk10.raw + +ifdef::wiki[] + +See Also +~~~~~~~~ + +* link:/wiki/Storage[Storage] + +endif::wiki[] + +