openstack/cinder
Code Issues Proposed changes

[docs] Update documentation for Infinidat driver

Browse Source 
* Add non-disruptive volume backup feature
* Add an item about creating a volume type
* Update the step for the user account as mentioned
  in the official Infinidat documentation

Signed-off-by: Alexander Deiter <adeiter@infinidat.com>
Change-Id: I46318679fa311ec9dbecb5da9557255b1f378465
This commit is contained in:
Alexander Deiter 2023-02-26 19:24:00 +00:00
parent e096b2db0e
commit e9816b6546
1 changed files with 21 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
doc/source/configuration/block-storage/drivers/infinidat-volume-driver.rst
View File

@ -27,6 +27,7 @@ Supported operations
* List manageable volumes and snapshots.
* Attach a volume to multiple instances at once (multi-attach).
* Host and storage assisted volume migration.
* Efficient non-disruptive volume backup.
External package installation
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -43,6 +44,11 @@ Setting up the storage array
Create a storage pool object on the InfiniBox array in advance.
The storage pool will contain volumes managed by OpenStack.
Mixing OpenStack APIs and non-OpenStack methods are not supported
when used to attach the same hosts via the same protocol.
For example, it is not possible to create boot-from-SAN volumes
and OpenStack volumes for the same host with Fibre Channel.
Instead, use a different protocol for one of the volumes.
Refer to the InfiniBox manuals for details on pool management.
Driver configuration
@ -89,7 +95,7 @@ Configure the driver back-end section with the parameters below.
The driver requires an InfiniBox user with administrative privileges.
We recommend creating a dedicated OpenStack user account
that holds an administrative user role.
that holds a pool admin user role.
Refer to the InfiniBox manuals for details on user account management.
Configure the user credentials by adding the following parameters:
@ -183,6 +189,20 @@ Configure the driver back-end section with the parameters below.
Volume compression is available on InfiniBox 3.0 onward.
After modifying the ``cinder.conf`` file, restart the ``cinder-volume``
service.
Create a new volume type for each distinct ``volume_backend_name`` value
that you added in the ``cinder.conf`` file. The example below assumes that
the same ``volume_backend_name=infinidat-pool-a`` option was specified in
all of the entries, and specifies that the volume type ``infinidat`` can be
used to allocate volumes from any of them. Example of creating a volume type:
.. code-block:: console
$ openstack volume type create infinidat
$ openstack volume type set --property volume_backend_name=infinidat-pool-a infinidat
Configuration example
~~~~~~~~~~~~~~~~~~~~~