pvecm: re-add "multiple cluster in same net" section

[pve-docs.git] / pve-storage-dir.adoc

diff --git a/pve-storage-dir.adoc b/pve-storage-dir.adoc
index d8bdb53f8b012c40725ea24789ee62521d538616..090a44b2ee62bb3f5707a001d632c346d55ae5a6 100644 (file)
--- a/pve-storage-dir.adoc
+++ b/pve-storage-dir.adoc
@@ -1,6 +1,10 @@
+[[storage_directory]]

 Directory Backend
 -----------------
 Directory Backend
 -----------------

-include::attributes.txt[]
+ifdef::wiki[]
+:pve-toplevel:
+:title: Storage: Directory
+endif::wiki[]

 
 Storage pool type: `dir`
 
 
 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.
 
 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.
 
 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
 [width="100%",cols="d,m",options="header"]
 |===========================================================
 |Content type        |Subdir

-|VM images           |images/<VMID>/
-|ISO images          |template/iso/
-|Container templates |template/cache
-|Backup files        |dump/
+|VM images           |`images/<VMID>/`
+|ISO images          |`template/iso/`
+|Container templates |`template/cache/`
+|Backup files        |`dump/`
+|Snippets            |`snippets/`

 |===========================================================
 
 |===========================================================
 

+

 Configuration
 ~~~~~~~~~~~~~
 
 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.
 
 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
 ----
 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
 
 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
 
 
 File naming conventions


@@ -70,16 +76,16 @@ This specifies the owner VM.
 
 `<NAME>`::
 
 
 `<NAME>`::
 

-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.
 
 `<FORMAT>`::
 
 backend uses `disk-[N]` as default, where `[N]` is replaced by an
 integer to make the name unique.
 
 `<FORMAT>`::
 

-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
 
 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-<VMID>-<NAME>.<FORMAT>
 
 
  base-<VMID>-<NAME>.<FORMAT>
 


@@ -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.
 
 backend changes the access mode to `0444`, and sets the immutable flag
 (`chattr +i`) if the storage supports that.
 

+

 Storage Features
 ~~~~~~~~~~~~~~~~
 
 Storage Features
 ~~~~~~~~~~~~~~~~
 


@@ -101,8 +108,8 @@ feature to create clones.
 .Storage features for backend `dir`
 [width="100%",cols="m,m,3*d",options="header"]
 |==============================================================================
 .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
 
  # 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.
 
 
 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
 
 
  # pvesm free local:100/vm-100-disk10.raw
 

+
+ifdef::wiki[]
+
+See Also
+~~~~~~~~
+
+* link:/wiki/Storage[Storage]
+
+endif::wiki[]
+
+