d7cbe16590d075346aaa2479dfd36c1a0baf8218
[pve-docs.git] / 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 vztmpl 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