Jump to: navigation, search

Difference between revisions of "Mellanox-Cinder"

m (Known Issues)
m
 
(6 intermediate revisions by 2 users not shown)
Line 27: Line 27:
 
= Known Issues =
 
= Known Issues =
  
(1)  “scsi-target-utils” package  
+
(1)  “scsi-target-utils” package:
  
 
'''Note''': For RH6.4 or below, “scsi-target-utils” package version needs to be 1.0.38 and above. If you use RDO installation, you should check the version.
 
'''Note''': For RH6.4 or below, “scsi-target-utils” package version needs to be 1.0.38 and above. If you use RDO installation, you should check the version.
Line 37: Line 37:
 
In addition, RH6.5 includes “scsi-target-utils” package with version 1.0.24-10. This version number is sufficient and no further action is needed for RHEL6.5.
 
In addition, RH6.5 includes “scsi-target-utils” package with version 1.0.24-10. This version number is sufficient and no further action is needed for RHEL6.5.
  
(2) Boot Instance from volume fails when iSER is enabled.
+
(2) Using old versions of Openstack (Havana release or lower), boot Instance from volume fails when iSER is enabled:
  
 
Steps to reproduce the bug:
 
Steps to reproduce the bug:
Line 55: Line 55:
 
  # service nova-compute restart  
 
  # service nova-compute restart  
  
(3) Flow control
+
(3) Flow control:
  
 
In case the network is Ethernet, make sure that flow control is enabled on the switches on the relevant ports across the network.
 
In case the network is Ethernet, make sure that flow control is enabled on the switches on the relevant ports across the network.
  
(4) Linux-IO (LIO) support limitation.
+
(4) Linux-IO (LIO) support limitation:
  
 
Open-source implementation of SCSI target in Openstack can be managed by either TGT or LIO.<br />
 
Open-source implementation of SCSI target in Openstack can be managed by either TGT or LIO.<br />
Currently in Openstack, iSER is supported over TGT only, and iSER support over LIO is scheduled for Kilo version.<br />
+
In Openstack, iSER is supported over TGT only until the Kilo version, and iSER support over LIO is available from the Kilo release.<br />
In case LIO is the default SCSI target, one must one install TGT and alter Openstack Cinder conf file to use TGT instead of lio.
+
Please use iscsi_helper parameter to specify the ISCSI target type (for more details, please follow: [http://docs.openstack.org/kilo/config-reference/content/section_volume-misc.html Cinder editional options]).
  
 
= References =
 
= References =
1. [http://www.mellanox.com/openstack/ OpenStack solution page at Mellanox site]
+
1. [http://docs.openstack.org/kilo/config-reference/content/lvm-volume-driver.html LVM driver documentation]
  
2. [https://github.com/mellanox-openstack Source repository]
+
2. [http://www.mellanox.com/openstack/ OpenStack solution page at Mellanox site]
  
3. [http://www.mellanox.com/page/products_dyn?product_family=26 Mellanox OFED web page]
+
3. [https://github.com/mellanox-openstack Legacy source repository]
 +
 
 +
4. [http://www.mellanox.com/page/products_dyn?product_family=26 Mellanox OFED web page]
 +
 
 +
5. [http://docs.openstack.org/havana/install-guide/install/yum/content/cinder-controller.html Cinder-controller for Havana]
 +
 
 +
6. [http://docs.openstack.org/havana/install-guide/install/yum/content/cinder-node.html Cinder-node for Havana]
  
4. [http://docs.openstack.org/havana/install-guide/install/yum/content/cinder-controller.html Cinder-controller]
 
  
5. [http://docs.openstack.org/havana/install-guide/install/yum/content/cinder-node.html Cinder-node]
 
  
 
Return to [https://wiki.openstack.org/wiki/Mellanox-OpenStack  Mellanox-OpenStack] wiki page.
 
Return to [https://wiki.openstack.org/wiki/Mellanox-OpenStack  Mellanox-OpenStack] wiki page.
  
For more details, please refer any inquiries to  [mailto:openstack@mellanox.com openstack@mellanox.com].
+
For more details, please direct any inquiries to  [mailto:openstack@mellanox.com openstack@mellanox.com].

Latest revision as of 07:45, 22 November 2016

Overview

Mellanox added iSCSI Extensions for RDMA (iSER) that does not need the TCP layer. Therefore, it provides lower latency and higher performance.
It permits data to be transferred directly into and out of SCSI computer memory buffers, which connects computers to storage devices, without intermediate data copies.
iSER is a server network protocol that extends the Internet Small Computer System Interface (iSCSI) protocol to use Remote Direct Memory Access (RDMA).

Please contact Mellanox for further information and benchmark results.

Installation

Provisioned through standard Cinder installation.

Configuration

In order to enable iSER, adjust these values at /etc/cinder/cinder.conf:

iscsi_ip_address = <ipoib/roce_address>
iscsi_protocol = iser
volume_driver = cinder.volume.drivers.lvm.LVMVolumeDriver

iscsi_ip_address is required to do a "discovery" over the IB/RoCE interface from the initiator side.

volume_driver points cinder to use the LVMVolumeDriver.

Restart Cinder service

#/etc/init.d/openstack-cinder-volume restart

For troubleshooting issues, refer to section Known Issues

Known Issues

(1) “scsi-target-utils” package:

Note: For RH6.4 or below, “scsi-target-utils” package version needs to be 1.0.38 and above. If you use RDO installation, you should check the version. The RPM can be found at http://www.mellanox.com/downloads/solutions/rpms/

#wget http://www.mellanox.com/downloads/solutions/rpms/scsi-target-utils-1.0.39-v1.0.39.c1135a.x86_64.rpm
#rpm -Uvh scsi-target-utils-1.0.39-v1.0.39.c1135a.x86_64.rpm

In addition, RH6.5 includes “scsi-target-utils” package with version 1.0.24-10. This version number is sufficient and no further action is needed for RHEL6.5.

(2) Using old versions of Openstack (Havana release or lower), boot Instance from volume fails when iSER is enabled:

Steps to reproduce the bug:

- Create new volume with image source.

- Launch a new instance boot from the above volume using iSER transport.

The bug is defined here: [1]

A patch can be found here: [2]

To apply the patch, run the following commands on all nova-compute nodes:

# wget http://www.mellanox.com/downloads/solutions/openstack/havana/patches/volume.patch 
# patch -p1 < volume.patch
# service nova-compute restart 

(3) Flow control:

In case the network is Ethernet, make sure that flow control is enabled on the switches on the relevant ports across the network.

(4) Linux-IO (LIO) support limitation:

Open-source implementation of SCSI target in Openstack can be managed by either TGT or LIO.
In Openstack, iSER is supported over TGT only until the Kilo version, and iSER support over LIO is available from the Kilo release.
Please use iscsi_helper parameter to specify the ISCSI target type (for more details, please follow: Cinder editional options).

References

1. LVM driver documentation

2. OpenStack solution page at Mellanox site

3. Legacy source repository

4. Mellanox OFED web page

5. Cinder-controller for Havana

6. Cinder-node for Havana


Return to Mellanox-OpenStack wiki page.

For more details, please direct any inquiries to openstack@mellanox.com.