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.7 KiB

Raw Blame History

X-IO volume driver

The X-IO volume driver for OpenStack Block Storage enables ISE products to be managed by OpenStack Block Storage nodes. This driver can be configured to work with iSCSI and Fibre Channel storage protocols. The X-IO volume driver allows the cloud operator to take advantage of ISE features like quality of service (QoS) and Continuous Adaptive Data Placement (CADP). It also supports creating thin volumes and specifying volume media affinity.

Requirements

ISE FW 2.8.0 or ISE FW 3.1.0 is required for OpenStack Block Storage support. The X-IO volume driver will not work with older ISE FW.

Supported operations

Create, delete, attach, detach, retype, clone, and extend volumes.
Create a volume from snapshot.
Create, list, and delete volume snapshots.
Manage and unmanage a volume.
Get volume statistics.
Create a thin provisioned volume.
Create volumes with QoS specifications.

Configure X-IO Volume driver

To configure the use of an ISE product with OpenStack Block Storage, modify your cinder.conf file as follows. Be careful to use the one that matches the storage protocol in use:

Fibre Channel

volume_driver = cinder.volume.drivers.xio.XIOISEFCDriver
san_ip = 1.2.3.4              # the address of your ISE REST management interface
san_login = administrator     # your ISE management admin login
san_password = password       # your ISE management admin password

iSCSI

volume_driver = cinder.volume.drivers.xio.XIOISEISCSIDriver
san_ip = 1.2.3.4              # the address of your ISE REST management interface
san_login = administrator     # your ISE management admin login
san_password = password       # your ISE management admin password
iscsi_ip_address = ionet_ip   # ip address to one ISE port connected to the IONET

Optional configuration parameters

Multipath

The X-IO ISE supports a multipath configuration, but multipath must be enabled on the compute node (see ISE Storage Blade Best Practices Guide). For more information, see X-IO Document Library.

Volume types

OpenStack Block Storage uses volume types to help the administrator specify attributes for volumes. These attributes are called extra-specs. The X-IO volume driver support the following extra-specs.

Extra specs
Extra-specs name	Valid values	Description
`Feature:Raid`	1, 5	RAID level for volume.
`Feature:Pool`	1 - n (n being number of pools on ISE)	Pool to create volume in.
`Affinity:Type`	cadp, flash, hdd	Volume media affinity type.
`Alloc:Type`	0 (thick), 1 (thin)	Allocation type for volume. Thick or thin.
`QoS:minIOPS`	n (value less than maxIOPS)	Minimum IOPS setting for volume.
`QoS:maxIOPS`	n (value bigger than minIOPS)	Maximum IOPS setting for volume.
`QoS:burstIOPS`	n (value bigger than minIOPS)	Burst IOPS setting for volume.

Examples

Create a volume type called xio1-flash for volumes that should reside on ssd storage:

$ openstack volume type create xio1-flash
$ openstack volume type set --property Affinity:Type=flash xio1-flash

Create a volume type called xio1 and set QoS min and max:

$ openstack volume type create xio1
$ openstack volume type set --property QoS:minIOPS=20 xio1
$ openstack volume type set --property QoS:maxIOPS=5000 xio1

3.7 KiB Raw Blame History