pve-storage-glusterfs.adoc

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