pve-storage-glusterfs.adoc

   1 GlusterFS Backend
   2 -----------------
   3 include::attributes.txt[]
   4
   5 ifdef::wiki[]
   6 :pve-toplevel:
   7 :title: Storage: GlusterFS
   8 endif::wiki[]
   9
  10 Storage pool type: `glusterfs`
  11
  12 GlusterFS is a salable network file system. The system uses a modular
  13 design, runs on commodity hardware, and can provide a highly available
  14 enterprise storage at low costs. Such system is capable of scaling to
  15 several petabytes, and can handle thousands of clients.
  16
  17 NOTE: After a node/brick crash, GlusterFS does a full `rsync` to make
  18 sure data is consistent. This can take a very long time with large
  19 files, so this backend is not suitable to store large VM images.
  20
  21 Configuration
  22 ~~~~~~~~~~~~~
  23
  24 The backend supports all common storage properties, and adds the
  25 following GlusterFS specific options:
  26
  27 `server`::
  28
  29 GlusterFS volfile server IP or DNS name.
  30
  31 `server2`::
  32
  33 Backup volfile server IP or DNS name.
  34
  35 `volume`::
  36
  37 GlusterFS Volume.
  38
  39 `transport`::
  40
  41 GlusterFS transport: `tcp`, `unix` or `rdma`
  42
  43
  44 .Configuration Example (`/etc/pve/storage.cfg`)
  45 ----
  46 glusterfs: Gluster
  47         server 10.2.3.4
  48         server2 10.2.3.5
  49         volume glustervol
  50         content images,iso
  51 ----
  52
  53
  54 File naming conventions
  55 ~~~~~~~~~~~~~~~~~~~~~~~
  56
  57 The directory layout and the file naming conventions are inherited
  58 from the `dir` backend.
  59
  60
  61 Storage Features
  62 ~~~~~~~~~~~~~~~~
  63
  64 The storage provides a file level interface, but no native
  65 snapshot/clone implementation.
  66
  67 .Storage features for backend `glusterfs`
  68 [width="100%",cols="m,m,3*d",options="header"]
  69 |==============================================================================
  70 |Content types             |Image formats   |Shared |Snapshots |Clones
  71 |images vztempl iso backup |raw qcow2 vmdk  |yes    |qcow2     |qcow2
  72 |==============================================================================
  73
  74 ifdef::wiki[]
  75
  76 See Also
  77 ~~~~~~~~
  78
  79 * link:/wiki/Storage[Storage]
  80
  81 endif::wiki[]
  82