spelling/grammar/capitalization
[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
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