d13fc46596a77bfee4921480b7337cd33716fb65
[pve-docs.git] / 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 File naming conventions
49 ~~~~~~~~~~~~~~~~~~~~~~~
50
51 The directory layout and the file naming conventions are inhertited
52 from the `dir` backend.
53
54 Storage Features
55 ~~~~~~~~~~~~~~~~
56
57 The storage provides a file level interface, but no native
58 snapshot/clone implementation.
59
60 .Storage features for backend `glusterfs`
61 [width="100%",cols="m,m,3*d",options="header"]
62 |==============================================================================
63 |Content types             |Image formats   |Shared |Snapshots |Clones
64 |images vztempl iso backup |raw qcow2 vmdk  |yes    |qcow2     |qcow2
65 |==============================================================================
66
67 ifdef::wiki[]
68
69 See Also
70 ~~~~~~~~
71
72 * link:/index.php/Storage[Storage]
73
74 endif::wiki[]
75