blob: 34b4dab9e27f0173cf048217eee1ecc6103ae4e6 [file] [log] [blame]
Filip Pytloun6828ea52015-07-30 14:47:24 +02001=========
2GlusterFS
3=========
4
5Install and configure GlusterFS server and client.
6
7Available states
8================
9
10.. contents::
11 :local:
12
13``glusterfs.server``
14--------------------
15
16Setup GlusterFS server
17
18``glusterfs.client``
19--------------------
20
21Setup GlusterFS client
22
23Available metadata
24==================
25
26.. contents::
27 :local:
28
29``metadata.glusterfs.server``
30-----------------------------
31
32Setup basic server
33
34
35``metadata.glusterfs.client``
36-----------------------------
37
38Setup client only
39
40Configuration parameters
41========================
42
43
44Example reclass
45===============
46
47Example for distributed glance images storage where every control node is
48gluster peer.
49
50.. code-block:: yaml
51
52 classes:
53 - service.glusterfs.server
54 - service.glusterfs.client
55
56 _param:
57 cluster_node01_address: 192.168.1.21
58 cluster_node02_address: 192.168.1.22
59 cluster_node03_address: 192.168.1.23
60 parameters:
61 glusterfs:
62 server:
63 peers:
64 - ${_param:cluster_node01_address}
65 - ${_param:cluster_node02_address}
66 - ${_param:cluster_node03_address}
67 volumes:
68 glance:
69 storage: /srv/glusterfs/glance
70 replica: 3
71 bricks:
72 - ${_param:cluster_node01_address}:/srv/glusterfs/glance
73 - ${_param:cluster_node02_address}:/srv/glusterfs/glance
74 - ${_param:cluster_node03_address}:/srv/glusterfs/glance
Filip Pytloun7dfd5d42015-07-30 16:08:27 +020075 options:
76 cluster.readdir-optimize: On
77 nfs.disable: On
78 network.remote-dio: On
79 diagnostics.client-log-level: WARNING
80 diagnostics.brick-log-level: WARNING
Filip Pytloun6828ea52015-07-30 14:47:24 +020081 client:
82 volumes:
83 glance:
84 path: /var/lib/glance/images
85 server: ${_param:cluster_node01_address}
86 user: glance
87 group: glance
88
89Example pillar
90==============
91
92Server
93------
94
95.. code-block:: yaml
96
97 glusterfs:
98 server:
99 peers:
100 - 192.168.1.21
101 - 192.168.1.22
102 - 192.168.1.23
103 volumes:
104 glance:
105 storage: /srv/glusterfs/glance
106 replica: 3
107 bricks:
108 - 172.168.1.21:/srv/glusterfs/glance
109 - 172.168.1.21:/srv/glusterfs/glance
110 - 172.168.1.21:/srv/glusterfs/glance
111
112Client
113------
114
115.. code-block:: yaml
116
117 glusterfs:
118 client:
119 volumes:
120 glance:
121 path: /var/lib/glance/images
122 server: 192.168.1.21
123 user: glance
124 group: glance
125
126Read more
127=========
128
129* https://www.gluster.org/