Jump to: navigation, search

Difference between revisions of "Cinder"

(add core team section and review links)
(Move devstack config information to driver testing page.)
Line 26: Line 26:
 
=== How To Contrbute A Driver ===
 
=== How To Contrbute A Driver ===
 
See [https://wiki.openstack.org/wiki/Cinder/how-to-contribute-a-driver How to contribute a driver]
 
See [https://wiki.openstack.org/wiki/Cinder/how-to-contribute-a-driver How to contribute a driver]
 
=== Configuring devstack to use your driver and backend ===
 
One of the things you'll be required to do when submitting a new driver is running your backend and driver in a devstack environment and executing the tempest volume tests against it.  Currently we provide a driver_cert wrapper (mentioned in the how-to-contribute-a-driver section).  One thing that causes some confusion is how do I configure devstack to use my backend device.  It used to be that your driver info would have to be added to lib/cinder in devstack to set your options.  We then created a cinder/plugin module in devstack.  Fortunately though it's MUCH easier than that.  For *most* drivers, the only changes that are made consist of cinder.conf file changes.  That can easily be accomplished by using devstacks local.conf file (more info here: http://devstack.org/configuration.html).  For more complex actions (like the need to install packages etc, the plugin directory in devstack can be used).  An example of what this file would look like to add driver FOO is shown below, the default localrc section is included for completeness, but the section of interest is the post-config cinder.conf section:
 
 
<nowiki>[[local|localrc]]</nowiki><br />
 
<sub>:# Passwords<br />
 
ADMIN_PASSWORD=password<br />
 
MYSQL_PASSWORD=password<br />
 
RABBIT_PASSWORD=password<br />
 
SERVICE_PASSWORD=password<br />
 
SERVICE_TOKEN=password<br />
 
SCREEN_LOGDIR=/opt/stack/logs<br />
 
HOST_IP=172.16.140.246<br />
 
disable_service n-net<br />
 
enable_service q-svc<br />
 
enable_service q-agt<br />
 
enable_service q-dhcp<br />
 
enable_service q-l3<br />
 
enable_service q-meta<br />
 
enable_service neutron<br />
 
<br />
 
 
<nowiki># These options define  expected driver capabilities </nowiki><br />
 
TEMPEST_VOLUME_DRIVER=foo<br />
 
TEMPEST_VOLUME_VENDOR="Foo Inc"<br />
 
TEMPEST_STORAGE_PROTOCOL=iSCSI<br />
 
<br />
 
<nowiki># These options allow you to specify a branch other than "master" be used </nowiki><br />
 
CINDER_REPO=https://review.openstack.org/openstack/cinder<br />
 
CINDER_BRANCH=refs/changes/83/72183/4<br />
 
<br />
 
<nowiki># Disable security groups entirely</nowiki><br />
 
Q_USE_SECGROUP=False<br />
 
LIBVIRT_FIREWALL_DRIVER=nova.virt.firewall.NoopFirewallDriver<br />
 
CINDER_SECURE_DELETE=False<br />
 
<br />
 
<nowiki>[[post-config|$CINDER_CONF]]</nowiki><br />
 
volume_driver = cinder.volume.drivers.foo.FooDriver<br />
 
foos_var = something<br />
 
another_foo_var = something-else</sub><br />
 
<br />
 
  
 
== Resources ==
 
== Resources ==

Revision as of 04:36, 18 December 2014

Official Title: OpenStack Block Storage Cinder

PTL: Mike Perez <thingee at gmail d0t com>

Mission Statement:
To implement services and libraries to provide on demand, self-service access to Block Storage resources. Provide Software Defined Block Storage via abstraction and automation on top of various traditional backend block storage devices.

Description

Cinder is a Block Storage service for OpenStack. It's designed to allow the use of either a reference implementation (LVM) to present storage resources to end users that can be consumed by the OpenStack Compute Project (Nova). The short description of Cinder is that it virtualizes pools of block storage devices and provides end users with a self service API to request and consume those resources without requiring any knowledge of where their storage is actually deployed or on what type of device.am

Core Team

See current members.

Project Meetings

See Meetings/Cinder.

Getting in Touch

We use the openstack-dev@lists.openstack.org mailing list for discussions using subjects with the prefix "[cinder]". We also hang out on IRC in #openstack-cinder on freenode.

Related projects

Core Volume Drivers

For a list of the core drivers in each OpenStack release and the volume operations they support, see https://wiki.openstack.org/wiki/CinderSupportMatrix

How To Contrbute A Driver

See How to contribute a driver

Resources

Review Links