pve-storage-glusterfs.adoc

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