Gitiles
Code Review Sign In
gerrit.mcp.mirantis.com / salt-formulas / glusterfs / refs/heads/feature/salt-orchestrate / . / README.rst
blob: d63e92dc08e2e98c73b61e9844b6bcb785bf78b1 [file] [log] [blame]
Filip Pytloun6828ea52015-07-30 14:47:24 +0200[diff] [blame]1=========
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
Filip Pytloun888c3db2015-09-07 13:45:09 +0200[diff] [blame]16Setup GlusterFS server (including both service and setup)
17
18``glusterfs.server.service``
19----------------------------
20
21Setup and start GlusterFS server service
22
23``glusterfs.server.setup``
24----------------------------
25
26Setup GlusterFS peers and volumes
Filip Pytloun6828ea52015-07-30 14:47:24 +0200[diff] [blame]27
28``glusterfs.client``
29--------------------
30
31Setup GlusterFS client
32
33Available metadata
34==================
35
36.. contents::
37 :local:
38
39``metadata.glusterfs.server``
40-----------------------------
41
42Setup basic server
43
44
45``metadata.glusterfs.client``
46-----------------------------
47
48Setup client only
49
50Configuration parameters
51========================
52
53
54Example reclass
55===============
56
57Example for distributed glance images storage where every control node is
58gluster peer.
59
60.. code-block:: yaml
61
62 classes:
63 - service.glusterfs.server
64 - service.glusterfs.client
65
66 _param:
67 cluster_node01_address: 192.168.1.21
68 cluster_node02_address: 192.168.1.22
69 cluster_node03_address: 192.168.1.23
70 parameters:
71 glusterfs:
72 server:
73 peers:
74 - ${_param:cluster_node01_address}
75 - ${_param:cluster_node02_address}
76 - ${_param:cluster_node03_address}
77 volumes:
78 glance:
79 storage: /srv/glusterfs/glance
80 replica: 3
81 bricks:
82 - ${_param:cluster_node01_address}:/srv/glusterfs/glance
83 - ${_param:cluster_node02_address}:/srv/glusterfs/glance
84 - ${_param:cluster_node03_address}:/srv/glusterfs/glance
Filip Pytloun7dfd5d42015-07-30 16:08:27 +0200[diff] [blame]85 options:
86 cluster.readdir-optimize: On
87 nfs.disable: On
88 network.remote-dio: On
89 diagnostics.client-log-level: WARNING
90 diagnostics.brick-log-level: WARNING
Filip Pytloun6828ea52015-07-30 14:47:24 +0200[diff] [blame]91 client:
92 volumes:
93 glance:
94 path: /var/lib/glance/images
95 server: ${_param:cluster_node01_address}
96 user: glance
97 group: glance
98
99Example pillar
100==============
101
102Server
103------
104
105.. code-block:: yaml
106
107 glusterfs:
108 server:
109 peers:
110 - 192.168.1.21
111 - 192.168.1.22
112 - 192.168.1.23
113 volumes:
114 glance:
115 storage: /srv/glusterfs/glance
116 replica: 3
117 bricks:
118 - 172.168.1.21:/srv/glusterfs/glance
119 - 172.168.1.21:/srv/glusterfs/glance
120 - 172.168.1.21:/srv/glusterfs/glance
Bogdan Radulescu3f27ebd2015-12-04 16:55:42 +0000[diff] [blame]121 enabled: true
Filip Pytloun6828ea52015-07-30 14:47:24 +0200[diff] [blame]122
123Client
124------
125
126.. code-block:: yaml
127
128 glusterfs:
129 client:
130 volumes:
131 glance:
132 path: /var/lib/glance/images
133 server: 192.168.1.21
134 user: glance
135 group: glance
Bogdan Radulescu3f27ebd2015-12-04 16:55:42 +0000[diff] [blame]136 enabled: true
Filip Pytloun6828ea52015-07-30 14:47:24 +0200[diff] [blame]137
138Read more
139=========
140
141* https://www.gluster.org/