Cinder, the OpenStack Block Storage Service¶
Cinder is an OpenStack project to provide “block storage as a service”.
- Component based architecture: Quickly add new behaviors
- Highly available: Scale to very serious workloads
- Fault-Tolerant: Isolated processes avoid cascading failures
- Recoverable: Failures should be easy to diagnose, debug, and rectify
- Open Standards: Be a reference implementation for a community-driven api
This documentation is generated by the Sphinx toolkit and lives in the source tree. Additional draft and project documentation on Cinder and other components of OpenStack can be found on the OpenStack wiki. Cloud administrators, refer to docs.openstack.org.
Installation Guide¶
Administration Guide¶
- Cinder Administration
- Increase Block Storage API service throughput
- Manage volumes
- Troubleshoot your installation
- Generalized filters
- Back up Block Storage service disks
- Boot from volume
- Consistency groups
- Configure and use driver filter and weighing for scheduler
- Get capabilities
- Generic volume groups
- Image-Volume cache
- Use LIO iSCSI support
- Configure multiple-storage back ends
- Configure an NFS storage back end
- Oversubscription in thin provisioning
- Rate-limit volume copy bandwidth
- Volume-backed image
- Export and import backup metadata
- Back up and restore volumes and snapshots
- Migrate volumes
- Volume multi-attach: Enable attaching a volume to multiple servers
- Configure and use volume number weigher
- Report backend state in service list
Configuration Reference¶
- Cinder Service Configuration
- Introduction to the Block Storage service
- Volume drivers
- Backup drivers
- Block Storage schedulers
- Log files used by Block Storage
- Policy configuration
- Fibre Channel Zone Manager
- Nested quotas
- Volume encryption supported by the key manager
- Additional options
- Block Storage service sample configuration files
- New, updated, and deprecated options in Ocata for Block Storage
- Sample Configuration File
- Sample Policy File
- Available Drivers
CLI Reference¶
Information on the commands available through Cinder’s Command Line Interface (CLI) can be found in this section of documentation.
Full documentation on the python-cinderclient is in the python-cinderclient documentation.
Contributor/Developer Docs¶
API Extensions¶
Go to https://developer.openstack.org/api-ref/block-storage/ for information about Cinder API extensions.
Block Storage v3 API Microversion History: The block storage v3 API evolves over time through API Microversions. This provides the history of all those changes. Consider it a “what’s new” in the block storage v3 API.
Indices and tables¶
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.