blob: 04bed673e7736ca0219004070db8e1f92d6ab8ca [file] [log] [blame]
Filip Pytlounda2a0792015-10-06 16:28:31 +02001==============================
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
18 database:
19 engine: mysql
20 host: 127.0.0.1
21 port: 3306
22 name: cinder
23 user: cinder
24 password: pwd
25 identity:
26 engine: keystone
27 host: 127.0.0.1
28 port: 35357
29 tenant: service
30 user: cinder
31 password: pwd
32 message_queue:
33 engine: rabbitmq
34 host: 127.0.0.1
35 port: 5672
36 user: openstack
37 password: pwd
38 virtual_host: '/openstack'
39 storage:
40 engine: file
41 types:
42 - name: 7k2_SAS
43 - name: 10k_SAS
44 - name: 15k_SAS
45
46 cinder:
47 volume:
48 enabled: true
49 version: juno
50 database:
51 engine: mysql
52 host: 127.0.0.1
53 port: 3306
54 name: cinder
55 user: cinder
56 password: pwd
57 identity:
58 engine: keystone
59 host: 127.0.0.1
60 port: 35357
61 tenant: service
62 user: cinder
63 password: pwd
64 message_queue:
65 engine: rabbitmq
66 host: 127.0.0.1
67 port: 5672
68 user: openstack
69 password: pwd
70 virtual_host: '/openstack'
71 storage:
72 engine: file
73 types:
74 - name: 7k2_SAS
75 - name: 10k_SAS
76 - name: 15k_SAS
77
78Cinder setup with zeroing deleted volumes
79
80 cinder:
81 controller:
82 enabled: true
83 wipe_method: zero
84 ...
85
86Cinder setup with shreding deleted volumes
87
88.. code-block:: yaml
89
90 cinder:
91 controller:
92 enabled: true
93 wipe_method: shred
94 ...
95
96
97Default Cinder setup with iSCSI target
98
99.. code-block:: yaml
100
101 cinder:
102 controller:
103 enabled: true
104 version: juno
105 database:
106 engine: mysql
107 host: 127.0.0.1
108 port: 3306
109 name: cinder
110 user: cinder
111 password: pwd
112 identity:
113 engine: keystone
114 host: 127.0.0.1
115 port: 35357
116 tenant: service
117 user: cinder
118 password: pwd
119 message_queue:
120 engine: rabbitmq
121 host: 127.0.0.1
122 port: 5672
123 user: openstack
124 password: pwd
125 virtual_host: '/openstack'
126 storage:
127 engine: file
128 types:
129 - name: 7k2_SAS
130 - name: 10k_SAS
131 - name: 15k_SAS
132
Ales Komarekdf13bbd2016-01-05 21:33:36 +0100133Cinder setup for IBM Storwize
Filip Pytlounda2a0792015-10-06 16:28:31 +0200134
135.. code-block:: yaml
136
137 cinder:
Ales Komarekdf13bbd2016-01-05 21:33:36 +0100138 volume:
Filip Pytlounda2a0792015-10-06 16:28:31 +0200139 enabled: true
Ales Komarekdf13bbd2016-01-05 21:33:36 +0100140 backend:
141 7k2_SAS:
142 engine: storwize
143 name: 7k2 SAS disk
144 host: 192.168.0.1
145 port: 22
146 user: username
147 password: pass
148 connection: FC/iSCSI
149 multihost: true
150 multipath: true
151 pool: SAS7K2
152 10k_SAS:
153 engine: storwize
154 name: 10k SAS disk
155 host: 192.168.0.1
156 port: 22
157 user: username
158 password: pass
159 connection: FC/iSCSI
160 multihost: true
161 multipath: true
162 pool: SAS10K
163 15k_SAS:
164 engine: storwize
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: SAS15K
Filip Pytlounda2a0792015-10-06 16:28:31 +0200173
174Cinder setup with Hitachi VPS
175
176.. code-block:: yaml
177
178 cinder:
179 controller:
180 enabled: true
181 types:
182 - name: HUS100
183 backend: hus100_backend
184 storage:
185 engine: hitachi_vsp
186 connection: FC
187
188Cinder setup with CEPH
189
190.. code-block:: yaml
191
192 cinder:
193 controller:
194 enabled: true
195 types:
196 - name: ceph
197 backend: ceph_backend
198 pool: volumes
199 storage:
200 engine: ceph
201 user: cinder
202 secret_uuid: da74ccb7-aa59-1721-a172-0006b1aa4e3e
203 client_cinder_key: AQDOavlU6BsSJhAAnpFR906mvdgdfRqLHwu0Uw==
204
205http://ceph.com/docs/master/rbd/rbd-openstack/
206
207
208Cinder setup with HP3par
209
210.. code-block:: yaml
211
212 cinder:
213 controller:
214 enabled: true
215 types:
216 - name: hp3par
217 backend: hp3par_backend
218 storage:
219 user: hp3paruser
220 password: something
221 url: http://10.10.10.10/api/v1
222 cpg: OpenStackCPG
223 host: 10.10.10.10
224 login: hp3paradmin
225 sanpassword: something
226 debug: True
227 snapcpg: OpenStackSNAPCPG
228
229Cinder setup with Fujitsu Eternus
230
231.. code-block:: yaml
232
233 cinder:
234 volume:
235 enabled: true
236 types:
237 - name: 10kThinPro
238 engine: fujitsu
239 pool: 10kThinPro
240 - name: 10k_SAS
241 pool: SAS10K
242 engine: fujitsu
243 storage:
244 engine: fujitsu
245 host: 192.168.0.1
246 port: 5988
247 user: username
248 password: pass
249 connection: FC/iSCSI
250
Jakub Pavlik9703c602015-10-15 18:52:47 +0200251Cinder setup with IBM GPFS filesystem
252
253.. code-block:: yaml
254
255 cinder:
256 volume:
257 enabled: true
258 types:
259 - name: GPFS-GOLD
260 engine: gpfs
261 mount_point: '/mnt/gpfs-openstack/cinder/gold'
262 - name: GPFS-SILVER
263 engine: gpfs
264 mount_point: '/mnt/gpfs-openstack/cinder/silver'
265 storage:
266 engine: gpfs
267
Filip Pytlounda2a0792015-10-06 16:28:31 +0200268## Read more
269
270* https://wiki.openstack.org/wiki/Cinder
271* http://docs.openstack.org/juno/config-reference/content/hitachi-configuration.html