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