openstack
/
cinder
Code Issues Proposed changes
cinder/doc/source/configuration/block-storage/drivers/open-e-joviandss-driver.rst

5.1 KiB
Raw Blame History

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
driver_ssl_cert_verify = True
driver_ssl_cert_path = /etc/cinder/jdss.crt
iscsi_target_prefix = iqn.2016-04.com.open-e.cinder:
jovian_pool = Pool-0
jovian_block_size = 128K
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]
driver_ssl_cert_verify True Verify authenticity of JovianDSS[1] certificate
driver_ssl_cert_path None Path to the JovianDSS[1] certificate for verification
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
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 purposes
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
driver_ssl_cert_verify = False
iscsi_target_prefix = iqn.2016-04.com.open-e.cinder:
jovian_pool = Pool-0
jovian_block_size = 128K
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
driver_ssl_cert_verify = False
iscsi_target_prefix = iqn.2016-04.com.open-e.cinder:
jovian_pool = Pool-1
jovian_block_size = 128K
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
  2. 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
driver_ssl_cert_verify = False
iscsi_target_prefix = iqn.2016-04.com.open-e.cinder:
jovian_pool = Pool-0
jovian_block_size = 128K
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