Infortrend volume driver

updated: 2024-06-21 07:19

Infortrend volume driver¶

The Infortrend volume driver is a Block Storage driver providing iSCSI and Fibre Channel support for Infortrend storages.

Supported operations¶

The Infortrend volume driver supports the following volume operations:

Create, delete, attach, and detach volumes.
Create and delete a snapshot.
Create a volume from a snapshot.
Copy an image to a volume.
Copy a volume to an image.
Clone a volume.
Extend a volume
Retype a volume.
Manage and unmanage a volume.
Migrate a volume with back-end assistance.
Live migrate an instance with volumes hosted on an Infortrend backend.

System requirements¶

To use the Infortrend volume driver, the following settings are required:

Set up Infortrend storage¶

Create logical volumes in advance.
Host side setting Peripheral device type should be No Device Present (Type=0x7f).

Set up cinder-volume node¶

Install JRE 7 or later.
Download the Infortrend storage CLI from the release page. Choose the raidcmd_ESDS10.jar file, which’s under v2.1.3 on the github releases page, and assign it to the default path /opt/bin/Infortrend/.

Driver configuration¶

On cinder-volume nodes, set the following in your /etc/cinder/cinder.conf, and use the following options to configure it:

Driver options¶

Description of Infortrend volume driver configuration options¶
Configuration option = Default value	Description
[DEFAULT]
`infortrend_cli_max_retries` = `5`	(Integer) The maximum retry times if a command fails.
`infortrend_cli_path` = `/opt/bin/Infortrend/raidcmd_ESDS10.jar`	(String) The Infortrend CLI absolute path.
`infortrend_cli_timeout` = `60`	(Integer) The timeout for CLI in seconds.
`infortrend_cli_cache` = `False`	(Boolean) The Infortrend CLI cache. Make sure the array is only managed by Openstack, and it is only used by one cinder-volume node. Otherwise, never enable it! The data might be asynchronous if there were any other operations.
`infortrend_pools_name` = `None`	(String) The Infortrend logical volumes name list. It is separated with comma.
`infortrend_iqn_prefix` = `iqn.2002-10.com.infortrend`	(String) Infortrend iqn prefix for iSCSI.
`infortrend_slots_a_channels_id` = `None`	(String) Infortrend raid channel ID list on Slot A for OpenStack usage. It is separated with comma.
`infortrend_slots_b_channels_id` = `None`	(String) Infortrend raid channel ID list on Slot A for OpenStack usage. It is separated with comma.
`java_path` = `/usr/bin/java`	(String) The Java absolute path.

iSCSI configuration example¶

[DEFAULT]
default_volume_type = IFT-ISCSI
enabled_backends = IFT-ISCSI

[IFT-ISCSI]
volume_driver = cinder.volume.drivers.infortrend.infortrend_iscsi_cli.InfortrendCLIISCSIDriver
volume_backend_name = IFT-ISCSI
infortrend_pools_name = POOL-1,POOL-2
san_ip = MANAGEMENT_PORT_IP
san_password = MANAGEMENT_PASSWORD
infortrend_slots_a_channels_id = 0,1,2,3
infortrend_slots_b_channels_id = 0,1,2,3

Fibre Channel configuration example¶

[DEFAULT]
default_volume_type = IFT-FC
enabled_backends = IFT-FC

[IFT-FC]
volume_driver = cinder.volume.drivers.infortrend.infortrend_fc_cli.InfortrendCLIFCDriver
volume_backend_name = IFT-FC
infortrend_pools_name = POOL-1,POOL-2,POOL-3
san_ip = MANAGEMENT_PORT_IP
san_password = MANAGEMENT_PASSWORD
infortrend_slots_a_channels_id = 4,5

Multipath configuration¶

Enable multipath for image transfer in /etc/cinder/cinder.conf for each back end or in [backend_defaults] section as a common configuration for all backends.
use_multipath_for_image_xfer = True
Restart the cinder-volume service.
Enable multipath for volume attach and detach in /etc/nova/nova.conf.
[libvirt] ... volume_use_multipath = True ...
Restart the nova-compute service.

Extra spec usage¶

infortrend:provisioning - Defaults to full provisioning, the valid values are thin and full.
infortrend:tiering - Defaults to use all tiering, the valid values are subsets of 0, 1, 2, 3.

If multi-pools are configured in cinder.conf, it can be specified for each pool, separated by semicolon.

For example:

infortrend:provisioning: POOL-1:thin; POOL-2:full

infortrend:tiering: POOL-1:all; POOL-2:0; POOL-3:0,1,3

For more details, see Infortrend documents.