Open-E JovianDSS iSCSI driver

The JovianISCSIDriver allows usage of Open-E Jovian Data Storage Solution to be used as Block Storage in OpenStack deployments.

Supported operations

  • Create, delete, attach, and detach volumes.

  • Create, list, and delete volume snapshots.

  • Create a volume from a snapshot.

  • Copy an image to a volume.

  • Copy a volume to an image.

  • Clone a volume.

  • Extend a volume.

  • Migrate a volume with back-end assistance.

Configuring

Edit with your favourite editor Cinder config file. It can be found at /etc/cinder/cinder.conf

Add the field enabled_backends with value jdss-0:

enabled_backends = jdss-0

Provide settings to JovianDSS driver by adding ‘jdss-0’ description:

[jdss-0]
backend_name = jdss-0
chap_password_len = 14
driver_use_ssl = True
iscsi_target_prefix = iqn.2016-04.com.open-e.cinder:
jovian_pool = Pool-0
jovian_block_size = 128K
jovian_rest_send_repeats = 4
san_api_port = 82
target_port = 3260
volume_driver = cinder.volume.drivers.open_e.iscsi.JovianISCSIDriver
san_hosts = 192.168.0.40
san_login = admin
san_password = admin
san_thin_provision = True
Open-E JovianDSS configuration options

Option

Default value

Description

backend_name

JovianDSS-iSCSI

Name of the back end

chap_password_len

12

Length of the unique generated CHAP password.

driver_use_ssl

True

Use SSL to send requests to JovianDSS[1]

iscsi_target_prefix

iqn.2016-04.com.open-e:01:cinder-

Prefix that will be used to form target name for volume

jovian_pool

Pool-0

Pool name that is going to be used. Must be created in [2]

jovian_block_size

128K

Block size for newly created volumes

jovian_rest_send_repeats

3

Number of times that driver will try to send REST request

san_api_port

82

Rest port according to the settings in [1]

target_port

3260

Port for iSCSI connections

volume_driver

Location of the driver source code

san_hosts

Comma separated list of IP address of the JovianDSS

san_login

admin

Must be set according to the settings in [1]

san_password

admin

Jovian password [1], should be changed for security purpouses

san_thin_provision

False

Using thin provisioning for new volumes

  1. JovianDSS Web interface/System Settings/REST Access

  2. Pool can be created by going to JovianDSS Web interface/Storage

More info about Open-E JovianDSS

Multiple Pools

In order to add another JovianDSS Pool, create a copy of JovianDSS config in cinder.conf file.

For instance if you want to add Pool-1 located on the same host as Pool-0. You extend cinder.conf file like:

enabled_backends = jdss-0, jdss-1

[jdss-0]
backend_name = jdss-0
chap_password_len = 14
driver_use_ssl = True
iscsi_target_prefix = iqn.2016-04.com.open-e.cinder:
jovian_pool = Pool-0
jovian_block_size = 128K
jovian_rest_send_repeats = 4
san_api_port = 82
target_port = 3260
volume_driver = cinder.volume.drivers.open_e.iscsi.JovianISCSIDriver
san_hosts = 192.168.0.40
san_login = admin
san_password = admin
san_thin_provision = True

[jdss-1]
backend_name = jdss-1
chap_password_len = 14
driver_use_ssl = True
iscsi_target_prefix = iqn.2016-04.com.open-e.cinder:
jovian_pool = Pool-1
jovian_block_size = 128K
jovian_rest_send_repeats = 4
san_api_port = 82
target_port = 3260
volume_driver = cinder.volume.drivers.open_e.iscsi.JovianISCSIDriver
san_hosts = 192.168.0.50
san_login = admin
san_password = admin
san_thin_provision = True

HA Cluster

To utilize High Availability feature of JovianDSS:

  1. Guide on configuring Pool to high availability cluster

  1. Set jovian_hosts with list of virtual IPs associated with this Pool

For instance if you have Pool-2 with 2 virtual IPs 192.168.21.100 and 192.168.31.100 the configuration file will look like:

[jdss-2]
backend_name = jdss-2
chap_password_len = 14
driver_use_ssl = True
iscsi_target_prefix = iqn.2016-04.com.open-e.cinder:
jovian_pool = Pool-0
jovian_block_size = 128K
jovian_rest_send_repeats = 4
san_api_port = 82
target_port = 3260
volume_driver = cinder.volume.drivers.open_e.iscsi.JovianISCSIDriver
san_hosts = 192.168.21.100, 192.168.31.100
san_login = admin
san_password = admin
san_thin_provision = True

Feedback

Please address problems and proposals to andrei.perepiolkin@open-e.com