Jay S. Bryant 986a6a015f [DOC BLD FIX] Name files for inclusion properly

The Sphinx build was issuing hundreds of warning for
duplicate labels.  The reason for this was because
all of the tables we had were named as .rst files.
This would cause Sphinx to process them twice and it would
think there were duplicated sections.

There were two ways this could be handled:  1) Exclude the tables
directory from the docs build. 2) Name the files as they should
have always been so they weren't build twice.  Given that
option 1 just masked the problem, I am implementing this
patch using option 2.

So, all the tables we are including in our documentation
have been named from .rst to .inc and the .. include::
directives that use them have also been updated to use
the new file name.

Change-Id: If395eb652f7e3b789bcbd5e6d6d05954c23d8d8a

2017-08-04 15:33:52 -05:00

3.4 KiB

Raw Blame History

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 Oracle Java 7 or later.
Download the Infortrend storage CLI from the release 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

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
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
infortrend_slots_a_channels_id = 4,5

Multipath configuration

Enable multipath for image transfer in /etc/cinder/cinder.conf.
```
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.

3.4 KiB Raw Blame History