LINSTOR driver

The LINSTOR driver allows Cinder to use DRBD/LINSTOR instances.

External package installation

The driver requires the python-linstor package for communication with the LINSTOR Controller. Install the package from PYPI using the following command:

$ python -m pip install python-linstor


Set the following option in the cinder.conf file for the DRBD transport:

volume_driver = cinder.volume.drivers.linstordrv.LinstorDrbdDriver

Or use the following for iSCSI transport:

volume_driver = cinder.volume.drivers.linstordrv.LinstorIscsiDriver

The following table contains the configuration options supported by the LINSTOR driver:

Description of LINSTOR configuration options

Configuration option = Default value


linstor_autoplace_count = 0

(Integer) Autoplace replication count on volume deployment. 0 = Full cluster replication without autoplace, 1 = Single node deployment without replication, 2 or greater = Replicated deployment with autoplace.

linstor_controller_diskless = True

(Boolean) True means Cinder node is a diskless LINSTOR node.

linstor_default_blocksize = 4096

(Integer) Default Block size for Image restoration. When using iSCSI transport, this option specifies the block size.

linstor_default_storage_pool_name = DfltStorPool

(String) Default Storage Pool name for LINSTOR.

linstor_default_uri = linstor://localhost

(String) Default storage URI for LINSTOR.

linstor_default_volume_group_name = drbd-vg

(String) Default Volume Group name for LINSTOR. Not Cinder Volume.

linstor_volume_downsize_factor = 4096

(Float) Default volume downscale size in KiB = 4 MiB.