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