Installs the OpenStack Block Storage service Cinder as part of the OpenStack reference deployment Chef for OpenStack. The https://github.com/stackforge/openstack-chef-repo contains documentation for using this cookbook in the context of a full OpenStack deployment. Cinder is currently installed from packages.

http://cinder.openstack.org

Requirements

Chef 0.10.0 or higher required (for Chef environment use).

Cookbooks

The following cookbooks are dependencies:

apt
openstack-common
openstack-identity
openstack-image
selinux (Fedora)

Usage

api

Installs the cinder-api, sets up the cinder database, and cinder service/user/endpoints in keystone

scheduler

Installs the cinder-scheduler service

volume

Installs the cinder-volume service and sets up the iscsi helper

Defaults to the ISCSI (LVM) Driver.

Attributes

openstack["block-storage"]["db"]["username"] - cinder username for database
openstack["block-storage"]["rabbit"]["username"] - Username for cinder rabbit access
openstack["block-storage"]["rabbit"]["vhost"] - The rabbit vhost to use
openstack["block-storage"]["rabbit"]["port"] - The rabbit port to use
openstack["block-storage"]["rabbit"]["host"] - The rabbit host to use (must set when openstack["block-storage"]["rabbit"]["ha"] false).
openstack["block-storage"]["rabbit"]["ha"] - Whether or not to use rabbit ha
openstack["block-storage"]["service_tenant_name"] - name of tenant to use for the cinder service account in keystone
openstack["block-storage"]["service_user"] - cinder service user in keystone
openstack["block-storage"]["service_role"] - role for the cinder service user in keystone
openstack["block-storage"]["syslog"]["use"]
openstack["block-storage"]["syslog"]["facility"]
openstack["block-storage"]["syslog"]["config_facility"]
openstack["block-storage"]["platform"] - hash of platform specific package/service names and options
openstack["block-storage"]["volume"]["state_path"] - Top-level directory for maintaining cinder's state
openstack["block-storage"]["volume"]["driver"] - Driver to use for volume creation
openstack["block-storage"]["volume"]["volume_group"] - Name for the VG that will contain exported volumes
openstack["block-storage"]["volume"]["iscsi_helper"] - ISCSI target user-land tool to use
openstack["block-storage"]["rbd_pool"] - RADOS Block Device pool to use
openstack["block-storage"]["rbd_user"] - User for Cephx Authentication
openstack["block-storage"]["rbd_secret_uuid"] - Secret UUID for Cephx Authentication
openstack["block-storage"]["policy"]["context_is_admin"] - Define administrators
openstack["block-storage"]["policy"]["default"] - default volume operations rule
openstack["block-storage"]["policy"]["admin_or_owner"] - Define an admin or owner
openstack["block-storage"]["policy"]["admin_api"] - Define api admin
openstack["block-storage"]["netapp"]["protocol"] - how are we talking to either dfm or filer, http or https
openstack["block-storage"]["netapp"]["dfm_hostname"] - Host or IP of your dfm server
openstack["block-storage"]["netapp"]["dfm_login"] - Username for dfm
openstack["block-storage"]["netapp"]["dfm_password"] - password for the dfm user
openstack["block-storage"]["netapp"]["dfm_port"] - default port for dfm
openstack["block-storage"]["netapp"]["dfm_web_port"] - web gui port for wsdl file download
openstack["block-storage"]["netapp"]["storage_service"] - name of the service in dfpm
openstack["block-storage"]["netapp"]["netapp_server_port"] - web admin port of the filer itself
openstack["block-storage"]["netapp"]["netapp_server_hostname"] - hostname of your filer, needs to be resolvable
openstack["block-storage"]["netapp"]["netapp_server_login"] - Username for netapp filer
openstack["block-storage"]["netapp"]["netapp_server_password"] - password for user above
openstack["block-storage"]["nfs"]["shares_config"] - file containing line by line entries of server:export
openstack["block-storage"]["nfs"]["mount_point_base"] - directory to mount NFS exported shares

Testing

This cookbook uses bundler, berkshelf, and strainer to isolate dependencies and run tests.

Tests are defined in Strainerfile.

To run tests:

$ bundle install # install gem dependencies
$ bundle exec berks install # install cookbook dependencies
$ bundle exec strainer test # run tests

License and Author


Author	Justin Shepherd (justin.shepherd@rackspace.com)
Author	Jason Cannavale (jason.cannavale@rackspace.com)
Author	Ron Pedde (ron.pedde@rackspace.com)
Author	Joseph Breu (joseph.breu@rackspace.com)
Author	William Kelly (william.kelly@rackspace.com)
Author	Darren Birkett (darren.birkett@rackspace.co.uk)
Author	Evan Callicoat (evan.callicoat@rackspace.com)
Author	Matt Ray (matt@opscode.com)
Author	Jay Pipes (jaypipes@att.com)
Author	John Dewey (jdewey@att.com)
Author	Abel Lopez (al592b@att.com)
Author	Sean Gallagher (sean.gallagher@att.com)
Author	Ionut Artarisi (iartarisi@suse.cz)

Copyright	Copyright (c) 2012, Rackspace US, Inc.
Copyright	Copyright (c) 2012-2013, AT&T Services, Inc.
Copyright	Copyright (c) 2013, Opscode, Inc.
Copyright	Copyright (c) 2013, SUSE Linux GmbH

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.