Gitiles
Code Review Sign In
gerrit.mcp.mirantis.com / salt-formulas / cinder / af96c2a73f36a45856e09fe0d5c40011aee7267a / . / README.rst
blob: afa04f76ac5b356e7c1ad94c6414cdf01266eb1c [file] [log] [blame]
Filip Pytlounda2a0792015-10-06 16:28:31 +0200[diff] [blame]1==============================
2Openstack Cinder Block Storage
3==============================
4
5Cinder provides an infrastructure for managing volumes in OpenStack. It was originally a Nova component called nova-volume, but has become an independent project since the Folsom release.
6
7Sample pillars
8==============
9
10New structure divides cinder-api,cinder-scheduler to role controller and cinder-volume to role volume.
11
12.. code-block:: yaml
13
14 cinder:
15 controller:
16 enabled: true
17 version: juno
Jakub Pavlikaf96c2a2016-01-08 15:49:54 +0100[diff] [blame^]18 default_volume_type: 7k2SaS
Filip Pytlounda2a0792015-10-06 16:28:31 +0200[diff] [blame]19 database:
20 engine: mysql
21 host: 127.0.0.1
22 port: 3306
23 name: cinder
24 user: cinder
25 password: pwd
26 identity:
27 engine: keystone
28 host: 127.0.0.1
29 port: 35357
30 tenant: service
31 user: cinder
32 password: pwd
33 message_queue:
34 engine: rabbitmq
35 host: 127.0.0.1
36 port: 5672
37 user: openstack
38 password: pwd
39 virtual_host: '/openstack'
Jakub Pavlikaf96c2a2016-01-08 15:49:54 +0100[diff] [blame^]40 backend:
41 7k2_SAS:
42 engine: storwize
43 name: 7k2 SAS disk
44 host: 192.168.0.1
45 port: 22
46 user: username
47 password: pass
48 connection: FC/iSCSI
49 multihost: true
50 multipath: true
51 pool: SAS7K2
Filip Pytlounda2a0792015-10-06 16:28:31 +0200[diff] [blame]52
53 cinder:
54 volume:
55 enabled: true
56 version: juno
Jakub Pavlikaf96c2a2016-01-08 15:49:54 +0100[diff] [blame^]57 default_volume_type: 7k2SaS
Filip Pytlounda2a0792015-10-06 16:28:31 +0200[diff] [blame]58 database:
59 engine: mysql
60 host: 127.0.0.1
61 port: 3306
62 name: cinder
63 user: cinder
64 password: pwd
65 identity:
66 engine: keystone
67 host: 127.0.0.1
68 port: 35357
69 tenant: service
70 user: cinder
71 password: pwd
72 message_queue:
73 engine: rabbitmq
74 host: 127.0.0.1
75 port: 5672
76 user: openstack
77 password: pwd
78 virtual_host: '/openstack'
Jakub Pavlikaf96c2a2016-01-08 15:49:54 +0100[diff] [blame^]79 backend:
80 7k2_SAS:
81 engine: storwize
82 name: 7k2 SAS disk
83 host: 192.168.0.1
84 port: 22
85 user: username
86 password: pass
87 connection: FC/iSCSI
88 multihost: true
89 multipath: true
90 pool: SAS7K2
Filip Pytlounda2a0792015-10-06 16:28:31 +0200[diff] [blame]91
92Cinder setup with zeroing deleted volumes
93
94 cinder:
95 controller:
96 enabled: true
97 wipe_method: zero
98 ...
99
100Cinder setup with shreding deleted volumes
101
102.. code-block:: yaml
103
104 cinder:
105 controller:
106 enabled: true
107 wipe_method: shred
108 ...
109
110
111Default Cinder setup with iSCSI target
112
113.. code-block:: yaml
114
115 cinder:
116 controller:
117 enabled: true
118 version: juno
Jakub Pavlikaf96c2a2016-01-08 15:49:54 +0100[diff] [blame^]119 default_volume_type: 7k2SaS
Filip Pytlounda2a0792015-10-06 16:28:31 +0200[diff] [blame]120 database:
121 engine: mysql
122 host: 127.0.0.1
123 port: 3306
124 name: cinder
125 user: cinder
126 password: pwd
127 identity:
128 engine: keystone
129 host: 127.0.0.1
130 port: 35357
131 tenant: service
132 user: cinder
133 password: pwd
134 message_queue:
135 engine: rabbitmq
136 host: 127.0.0.1
137 port: 5672
138 user: openstack
139 password: pwd
140 virtual_host: '/openstack'
Jakub Pavlikaf96c2a2016-01-08 15:49:54 +0100[diff] [blame^]141 backend:
142 7k2_SAS:
143 engine: storwize
144 name: 7k2 SAS disk
145 host: 192.168.0.1
146 port: 22
147 user: username
148 password: pass
149 connection: FC/iSCSI
150 multihost: true
151 multipath: true
152 pool: SAS7K2
Filip Pytlounda2a0792015-10-06 16:28:31 +0200[diff] [blame]153
Ales Komarekdf13bbd2016-01-05 21:33:36 +0100[diff] [blame]154Cinder setup for IBM Storwize
Filip Pytlounda2a0792015-10-06 16:28:31 +0200[diff] [blame]155
156.. code-block:: yaml
157
158 cinder:
Ales Komarekdf13bbd2016-01-05 21:33:36 +0100[diff] [blame]159 volume:
Filip Pytlounda2a0792015-10-06 16:28:31 +0200[diff] [blame]160 enabled: true
Ales Komarekdf13bbd2016-01-05 21:33:36 +0100[diff] [blame]161 backend:
162 7k2_SAS:
163 engine: storwize
164 name: 7k2 SAS disk
165 host: 192.168.0.1
166 port: 22
167 user: username
168 password: pass
169 connection: FC/iSCSI
170 multihost: true
171 multipath: true
172 pool: SAS7K2
173 10k_SAS:
174 engine: storwize
175 name: 10k SAS disk
176 host: 192.168.0.1
177 port: 22
178 user: username
179 password: pass
180 connection: FC/iSCSI
181 multihost: true
182 multipath: true
183 pool: SAS10K
184 15k_SAS:
185 engine: storwize
186 host: 192.168.0.1
187 port: 22
188 user: username
189 password: pass
190 connection: FC/iSCSI
191 multihost: true
192 multipath: true
193 pool: SAS15K
Filip Pytlounda2a0792015-10-06 16:28:31 +0200[diff] [blame]194
195Cinder setup with Hitachi VPS
196
197.. code-block:: yaml
198
199 cinder:
200 controller:
201 enabled: true
Jakub Pavlik5d7df0d2016-01-06 13:08:30 +0100[diff] [blame]202 backend:
203 hus100_backend:
204 name: HUS100
205 backend: hus100_backend
206 engine: hitachi_vsp
207 connection: FC
Filip Pytlounda2a0792015-10-06 16:28:31 +0200[diff] [blame]208
209Cinder setup with CEPH
210
211.. code-block:: yaml
212
213 cinder:
214 controller:
215 enabled: true
Jakub Pavlik5d7df0d2016-01-06 13:08:30 +0100[diff] [blame]216 backend:
217 ceph_backend:
218 name: standard-iops
219 backend: ceph_backend
220 pool: volumes
221 engine: ceph
222 user: cinder
223 secret_uuid: da74ccb7-aa59-1721-a172-0006b1aa4e3e
224 client_cinder_key: AQDOavlU6BsSJhAAnpFR906mvdgdfRqLHwu0Uw==
Filip Pytlounda2a0792015-10-06 16:28:31 +0200[diff] [blame]225
226http://ceph.com/docs/master/rbd/rbd-openstack/
227
228
229Cinder setup with HP3par
230
231.. code-block:: yaml
232
233 cinder:
234 controller:
235 enabled: true
Jakub Pavlik5d7df0d2016-01-06 13:08:30 +0100[diff] [blame]236 backend:
237 hp3par_backend:
238 name: hp3par
239 backend: hp3par_backend
240 user: hp3paruser
241 password: something
242 url: http://10.10.10.10/api/v1
243 cpg: OpenStackCPG
244 host: 10.10.10.10
245 login: hp3paradmin
246 sanpassword: something
247 debug: True
248 snapcpg: OpenStackSNAPCPG
Filip Pytlounda2a0792015-10-06 16:28:31 +0200[diff] [blame]249
250Cinder setup with Fujitsu Eternus
251
252.. code-block:: yaml
253
254 cinder:
255 volume:
256 enabled: true
Jakub Pavlik5d7df0d2016-01-06 13:08:30 +0100[diff] [blame]257 backend:
258 10kThinPro:
259 name: 10kThinPro
260 engine: fujitsu
261 pool: 10kThinPro
262 host: 192.168.0.1
263 port: 5988
264 user: username
265 password: pass
266 connection: FC/iSCSI
267 10k_SAS:
268 name: 10k_SAS
269 pool: SAS10K
270 engine: fujitsu
271 host: 192.168.0.1
272 port: 5988
273 user: username
274 password: pass
275 connection: FC/iSCSI
Filip Pytlounda2a0792015-10-06 16:28:31 +0200[diff] [blame]276
Jakub Pavlik9703c602015-10-15 18:52:47 +0200[diff] [blame]277Cinder setup with IBM GPFS filesystem
278
279.. code-block:: yaml
280
281 cinder:
282 volume:
283 enabled: true
Jakub Pavlik5d7df0d2016-01-06 13:08:30 +0100[diff] [blame]284 backend:
285 GPFS-GOLD:
286 name: GPFS-GOLD
287 engine: gpfs
288 mount_point: '/mnt/gpfs-openstack/cinder/gold'
289 GPFS-SILVER
290 name: GPFS-SILVER
291 engine: gpfs
292 mount_point: '/mnt/gpfs-openstack/cinder/silver'
293
Filip Pytlounda2a0792015-10-06 16:28:31 +0200[diff] [blame]294## Read more
295
296* https://wiki.openstack.org/wiki/Cinder
297* http://docs.openstack.org/juno/config-reference/content/hitachi-configuration.html