Add new LINSTOR volume driver

LINSTOR is a storage orchestrator for DRBD.

Change-Id: Ic3a4f85c10a2432d4128fce08604e9868722e8f7

cinder/opts.py

@@ -127,6 +127,8 @@ from cinder.volume.drivers.kaminario import kaminario_common as \
     cinder_volume_drivers_kaminario_kaminariocommon
 from cinder.volume.drivers.lenovo import lenovo_common as \
     cinder_volume_drivers_lenovo_lenovocommon
+from cinder.volume.drivers import linstordrv as \
+    cinder_volume_drivers_linstordrv
 from cinder.volume.drivers import lvm as cinder_volume_drivers_lvm
 from cinder.volume.drivers.netapp import options as \
     cinder_volume_drivers_netapp_options
@@ -310,6 +312,7 @@ def list_opts():
                 kaminario_opts,
                 cinder_volume_drivers_lenovo_lenovocommon.common_opts,
                 cinder_volume_drivers_lenovo_lenovocommon.iscsi_opts,
+                cinder_volume_drivers_linstordrv.linstor_opts,
                 cinder_volume_drivers_lvm.volume_opts,
                 cinder_volume_drivers_netapp_options.netapp_proxy_opts,
                 cinder_volume_drivers_netapp_options.netapp_connection_opts,

doc/source/configuration/block-storage/drivers/linstor-driver.rst

@@ -0,0 +1,29 @@
+==============
+LINSTOR driver
+==============
+
+The LINSTOR driver allows Cinder to use DRBD/LINSTOR instances.
+
+Configuration
+~~~~~~~~~~~~~
+
+Set the following option in the ``cinder.conf`` file for the DRBD transport:
+
+.. code-block:: ini
+
+   volume_driver = cinder.volume.drivers.linstordrv.LinstorDrbdDriver
+
+Or use the following for iSCSI transport:
+
+.. code-block:: ini
+
+   volume_driver = cinder.volume.drivers.linstordrv.LinstorIscsiDriver
+
+
+The following table contains the configuration options supported by the
+LINSTOR driver:
+
+.. config-table::
+   :config-target: LINSTOR
+
+   cinder.volume.drivers.linstordrv

doc/source/configuration/block-storage/volume-drivers.rst

@@ -39,8 +39,8 @@ Driver Configuration Reference
    drivers/dell-emc-vnx-driver
    drivers/dell-emc-vmax-driver
    drivers/dell-emc-vxflex-driver
-   drivers/emc-xtremio-driver
    drivers/drbd-driver
+   drivers/emc-xtremio-driver
    drivers/fujitsu-eternus-dx-driver
    drivers/hpe-3par-driver
    drivers/hpe-lefthand-driver
@@ -54,6 +54,7 @@ Driver Configuration Reference
    drivers/inspur-instorage-driver
    drivers/kaminario-driver
    drivers/lenovo-driver
+   drivers/linstor-driver
    drivers/nec-storage-m-series-driver
    drivers/netapp-volume-driver
    drivers/nimble-volume-driver

doc/source/reference/support-matrix.ini

@@ -111,6 +111,9 @@ title=Lenovo Storage Driver (FC, iSCSI)
 [driver.linbit_drbd]
 title=LinBit DRDB Driver (DRBD)
 
+[driver.linbit_linstor]
+title=LINBIT DRBD/LINSTOR Driver (DRBD)
+
 [driver.lvm]
 title=Logical Volume Manager (LVM) Reference Driver (iSCSI)
 
@@ -231,6 +234,7 @@ driver.inspur=complete
 driver.kaminario=complete
 driver.lenovo=complete
 driver.linbit_drbd=complete
+driver.linbit_linstor=complete
 driver.lvm=complete
 driver.nec=complete
 driver.netapp_ontap=complete
@@ -295,6 +299,7 @@ driver.inspur=complete
 driver.kaminario=complete
 driver.lenovo=complete
 driver.linbit_drbd=complete
+driver.linbit_linstor=complete
 driver.lvm=complete
 driver.nec=complete
 driver.netapp_ontap=missing
@@ -359,6 +364,7 @@ driver.inspur=complete
 driver.kaminario=missing
 driver.lenovo=missing
 driver.linbit_drbd=missing
+driver.linbit_linstor=missing
 driver.lvm=missing
 driver.nec=complete
 driver.netapp_ontap=missing
@@ -424,6 +430,7 @@ driver.inspur=complete
 driver.kaminario=missing
 driver.lenovo=missing
 driver.linbit_drbd=missing
+driver.linbit_linstor=missing
 driver.lvm=missing
 driver.nec=complete
 driver.netapp_ontap=complete
@@ -490,6 +497,7 @@ driver.inspur=complete
 driver.kaminario=complete
 driver.lenovo=missing
 driver.linbit_drbd=missing
+driver.linbit_linstor=missing
 driver.lvm=missing
 driver.nec=missing
 driver.netapp_ontap=complete
@@ -557,6 +565,7 @@ driver.inspur=complete
 driver.kaminario=missing
 driver.lenovo=missing
 driver.linbit_drbd=missing
+driver.linbit_linstor=missing
 driver.lvm=missing
 driver.nec=missing
 driver.netapp_ontap=complete
@@ -623,6 +632,7 @@ driver.inspur=missing
 driver.kaminario=complete
 driver.lenovo=missing
 driver.linbit_drbd=missing
+driver.linbit_linstor=missing
 driver.lvm=complete
 driver.nec=missing
 driver.netapp_ontap=complete
@@ -690,6 +700,7 @@ driver.inspur=missing
 driver.kaminario=missing
 driver.lenovo=missing
 driver.linbit_drbd=missing
+driver.linbit_linstor=missing
 driver.lvm=missing
 driver.nec=missing
 driver.netapp_ontap=missing
@@ -757,6 +768,7 @@ driver.inspur=missing
 driver.kaminario=missing
 driver.lenovo=missing
 driver.linbit_drbd=missing
+driver.linbit_linstor=missing
 driver.lvm=complete
 driver.nec=missing
 driver.netapp_ontap=complete

driver-requirements.txt

@@ -27,6 +27,11 @@ pywbem>=0.7.0 # LGPLv2.1+
 # IBM XIV
 pyxcli>=1.1.5 # Apache-2.0
 
+# LINSTOR
+protobuf>=3.6.1 # BSD
+eventlet>=0.24.1 # MIT
+python-linstor>=0.6.2 # GPLv3
+
 # RBD
 rados # LGPLv2.1
 rbd # LGPLv2.1

releasenotes/notes/drbd-linstor-volume-driver-20273a9ad3783cf5.yaml

@@ -0,0 +1,4 @@
+---
+features:
+  - |
+    New Cinder volume driver for LINBIT LINSTOR resources.