Difference between revisions of "OpenStack Cinder"

From OSNEXUS Online Documentation Site
Jump to: navigation, search
m (→‎Download QuantaStor OpenStack Cinder Driver)
m (→‎Overview)
 
(19 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
== Setup ==
+
[[Category:integration_guide]]
−
All of our testing has been done in a DevStack environment.
+
== Overview ==
−
Here is a link to their website / setup instructions:
+
[[File:qs_openstack_cinder.png|thumb|600px|QuantaStor integrates via two Cinder modules, one for ZFS based Storage Pools, one for Ceph based Storage Pools.]]
  
−
[http://devstack.org/ http://devstack.org/]
+
QuantaStor integrates with Openstack via two separate Cinder modules depending on the cluster type.
 +
 
 +
For integration with QuantaStor Storage Pool based on Ceph use the standard Openstack Cinder module for use with Ceph via the [http://docs.ceph.com/docs/master/rbd/rbd-openstack/#configuring-cinder Ceph documentation outlined here]. 
 +
 
 +
For integration with QuantaStor Storage Pools based on ZFS use the OSNEXUS QuantaStor Openstack Cinder module which provides iSCSI block storage to OpenStack managed virtual machines. 
 +
 
 +
The following guide covers setup and configuration of the QuantaStor Cinder module for use with ZFS based Storage Pools which deliver iSCSI Storage Volumes to OpenStack.
 +
 
 +
Note that we automate our testing using tempest and a [http://devstack.org/ DevStack] based OpenStack environment.
 +
 
 +
== Setup ==
  
 
Before running ./stack.sh make sure to add these to your devstack/local.conf file. If there is no local.conf file, you can create your own, or copy the file in the devstack/samples/ directory
 
Before running ./stack.sh make sure to add these to your devstack/local.conf file. If there is no local.conf file, you can create your own, or copy the file in the devstack/samples/ directory
Line 49: Line 59:
 
|-
 
|-
 
! scope="col"| Feature
 
! scope="col"| Feature
−
! scope="col"| Havana
+
! scope="col"| Pike
−
! scope="col"| Icehouse
+
! scope="col"| Queens
 +
! scope="col"| Rocky
 +
! scope="col"| Stein
 
! scope="col"| QuantaStor / Feature Coverage
 
! scope="col"| QuantaStor / Feature Coverage
 
|-
 
|-
 
! scope="row"| Volume Attach/Detach
 
! scope="row"| Volume Attach/Detach
 +
| style="text-align: center" | Available
 +
| style="text-align: center" | Available
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
Line 59: Line 73:
 
|-
 
|-
 
! scope="row"| Snapshot Create/Delete
 
! scope="row"| Snapshot Create/Delete
 +
| style="text-align: center" | Available
 +
| style="text-align: center" | Available
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
Line 64: Line 80:
 
|-
 
|-
 
! scope="row"| Create Volume from Snapshot
 
! scope="row"| Create Volume from Snapshot
 +
| style="text-align: center" | Available
 +
| style="text-align: center" | Available
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
Line 71: Line 89:
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
−
| style="background-color: #F3F781;text-align: center" | In Progress
+
| style="text-align: center" | Available
 +
| style="text-align: center" | Available
 +
| style="background-color: #9FF781;text-align: center" | Yes
 
|-
 
|-
 
! scope="row"| Copy Image to Volume
 
! scope="row"| Copy Image to Volume
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
−
| style="background-color: #D8D8D8;text-align: center" | N/A
+
| style="text-align: center" | Available
 +
| style="text-align: center" | Available
 +
| style="background-color: #9FF781;text-align: center" | Yes
 
|-
 
|-
 
! scope="row"| Copy Volume to Image
 
! scope="row"| Copy Volume to Image
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
−
| style="background-color: #D8D8D8;text-align: center" | N/A
+
| style="text-align: center" | Available
 +
| style="text-align: center" | Available
 +
| style="background-color: #9FF781;text-align: center" | Yes
 
|-
 
|-
 
! scope="row"| Clone Volume
 
! scope="row"| Clone Volume
 +
| style="text-align: center" | Available
 +
| style="text-align: center" | Available
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
Line 89: Line 115:
 
|-
 
|-
 
! scope="row"| Extend Volume
 
! scope="row"| Extend Volume
−
| style="text-align: center" | N/A
+
| style="text-align: center" | Available
 +
| style="text-align: center" | Available
 +
| style="text-align: center" | Available
 
| style="text-align: center" | Available
 
| style="text-align: center" | Available
 
| style="background-color: #9FF781;text-align: center" | Yes
 
| style="background-color: #9FF781;text-align: center" | Yes
Line 96: Line 124:
 
== Download QuantaStor OpenStack Cinder Driver ==
 
== Download QuantaStor OpenStack Cinder Driver ==
  
−
Note that we're still working with our partners on testing the QuantaStor OpenStack Cinder driver.  If you'd like access to this early driver it is available [https://dl.dropboxusercontent.com/u/9076477/partner/cinder/QuantaStor.py here]. If you have feedback for us please send email to support@osnexus.com.
+
Select the correct version for your OpenStack deployment
 +
 
 +
[http://qstor-downloads.s3.amazonaws.com/cinder/Icehouse/QuantaStor.py Havana / Icehouse]
 +
 
 +
[http://qstor-downloads.s3.amazonaws.com/cinder/Juno/QuantaStor.py Juno / Kilo]
 +
 
 +
[http://qstor-downloads.s3.amazonaws.com/cinder/liberty/QuantaStor.py Liberty]
 +
 
 +
If you have feedback for us please send email to support@osnexus.com.
  
 
== Command Examples ==
 
== Command Examples ==

Latest revision as of 05:40, 9 September 2021

Overview

QuantaStor integrates via two Cinder modules, one for ZFS based Storage Pools, one for Ceph based Storage Pools.

QuantaStor integrates with Openstack via two separate Cinder modules depending on the cluster type.

For integration with QuantaStor Storage Pool based on Ceph use the standard Openstack Cinder module for use with Ceph via the Ceph documentation outlined here.

For integration with QuantaStor Storage Pools based on ZFS use the OSNEXUS QuantaStor Openstack Cinder module which provides iSCSI block storage to OpenStack managed virtual machines.

The following guide covers setup and configuration of the QuantaStor Cinder module for use with ZFS based Storage Pools which deliver iSCSI Storage Volumes to OpenStack.

Note that we automate our testing using tempest and a DevStack based OpenStack environment.

Setup

Before running ./stack.sh make sure to add these to your devstack/local.conf file. If there is no local.conf file, you can create your own, or copy the file in the devstack/samples/ directory (replace with values for your QuantaStor) 

[[post-config|$CINDER_CONF]]
[DEFAULT]
volume_driver=cinder.volume.drivers.QuantaStor.QuantaStorDriver
qs_ip=192.168.0.101
qs_pool_id=fdb0f5c5-834a-1220-96a1-9a5d3f6664a9
qs_user = admin
qs_password = password

These two lines need to be added to the /opt/stack/cinder/cinder/volume/manager.py file: 

'cinder.volume.drivers.QuantaStor.QuantaStorDriver':
'cinder.volume.drivers.QuantaStor.QuantaStorDriver',

For me it is right after line 96. It is in the "MAPPING = {" section with all the other drivers.

Also before running ./stack.sh, make sure that you run the setup with a non root user. This user needs to have password-less sudo privileges to make the process much easier. To create such a user, go through the following steps.

  • In your linux session, type : 'cd devstack'
  • Use a text editor to access /etc/sudoers like : 'sudo visudo /etc/sudoers'
  • Find a line that should look similar, if not identical to this : '%root All=(ALL) ALL'
  • Under that line, write this, making sure to replace 'user' with your username : 'user ALL=(ALL) NOPASSWD:ALL'

Things to Note

  • DevStack runs a bunch of sessions in screens
  • Touch and chmod 777 the file "/var/log/qs_cinder.log" to have the QuantaStor driver also log to a seperate file

Feature Support

Feature Pike Queens Rocky Stein QuantaStor / Feature Coverage
Volume Attach/Detach Available Available Available Available Yes
Snapshot Create/Delete Available Available Available Available Yes
Create Volume from Snapshot Available Available Available Available Yes
Get Volume Stats Available Available Available Available Yes
Copy Image to Volume Available Available Available Available Yes
Copy Volume to Image Available Available Available Available Yes
Clone Volume Available Available Available Available Yes
Extend Volume Available Available Available Available Yes

Download QuantaStor OpenStack Cinder Driver

Select the correct version for your OpenStack deployment

Havana / Icehouse

Juno / Kilo

Liberty

If you have feedback for us please send email to support@osnexus.com.

Command Examples

Retrieved from "https://wiki.osnexus.com/index.php?title=OpenStack_Cinder&oldid=19524"