Huawei: Update huawei cinder driver configuration file for ocata.
1.Add the new storage system that huawei cinder driver supports. 2.Add the new features huawei cinder driver supports. 3.Add configuration for hypermetro and replicaiton. Change-Id: Ie028c3150fd4e17a248f76a8baefd9100bdc39f5 Closes-Bug: #1670271
This commit is contained in:
liucheng
parent
96a2c5ced5
commit
ee9c159449
|
|
@ -19,23 +19,29 @@ driver, Huawei storage system and OpenStack:
|
||||||
|
|
||||||
* - Description
|
* - Description
|
||||||
- Storage System Version
|
- Storage System Version
|
||||||
* - Create, delete, expand, attach, detach, manage, and unmanage volumes.
|
* - Create, delete, expand, attach, detach, manage and unmanage volumes
|
||||||
|
|
||||||
Create, delete, manage, unmanage, and backup a snapshot.
|
Create volumes with assigned storage pools
|
||||||
|
|
||||||
Create, delete, and update a consistency group.
|
Create volumes with assigned disk types
|
||||||
|
|
||||||
Create and delete a cgsnapshot.
|
Create, delete and update a consistency group
|
||||||
|
|
||||||
Copy an image to a volume.
|
Copy an image to a volume
|
||||||
|
|
||||||
Copy a volume to an image.
|
Copy a volume to an image
|
||||||
|
|
||||||
Create a volume from a snapshot.
|
Auto Zoning
|
||||||
|
|
||||||
Clone a volume.
|
SmartThin
|
||||||
|
|
||||||
QoS
|
Volume Migration
|
||||||
|
|
||||||
|
Replication V2.1
|
||||||
|
|
||||||
|
Create, delete, manage, unmanage and backup snapshots
|
||||||
|
|
||||||
|
Create and delete a cgsnapshot
|
||||||
- OceanStor T series V2R2 C00/C20/C30
|
- OceanStor T series V2R2 C00/C20/C30
|
||||||
|
|
||||||
OceanStor V3 V3R1C10/C20 V3R2C10 V3R3C00
|
OceanStor V3 V3R1C10/C20 V3R2C10 V3R3C00
|
||||||
|
|
@ -45,17 +51,21 @@ driver, Huawei storage system and OpenStack:
|
||||||
OceanStor 2600V3 V300R005C00
|
OceanStor 2600V3 V300R005C00
|
||||||
|
|
||||||
OceanStor 18500/18800 V1R1C00/C20/C30 V3R3C00
|
OceanStor 18500/18800 V1R1C00/C20/C30 V3R3C00
|
||||||
* - Volume Migration
|
|
||||||
|
|
||||||
Auto zoning
|
OceanStor Dorado V300R001C00
|
||||||
|
* - Clone a volume
|
||||||
|
|
||||||
|
Create volume from snapshot
|
||||||
|
|
||||||
|
Retype
|
||||||
|
|
||||||
|
SmartQoS
|
||||||
|
|
||||||
SmartTier
|
SmartTier
|
||||||
|
|
||||||
SmartCache
|
SmartCache
|
||||||
|
|
||||||
Smart Thin/Thick
|
Thick
|
||||||
|
|
||||||
Replication V2.1
|
|
||||||
- OceanStor T series V2R2 C00/C20/C30
|
- OceanStor T series V2R2 C00/C20/C30
|
||||||
|
|
||||||
OceanStor V3 V3R1C10/C20 V3R2C10 V3R3C00
|
OceanStor V3 V3R1C10/C20 V3R2C10 V3R3C00
|
||||||
|
|
@ -73,45 +83,14 @@ driver, Huawei storage system and OpenStack:
|
||||||
OceanStor 2600V3 V300R005C00
|
OceanStor 2600V3 V300R005C00
|
||||||
|
|
||||||
OceanStor 18500/18800V1R1C00/C20/C30
|
OceanStor 18500/18800V1R1C00/C20/C30
|
||||||
|
* - Hypermetro
|
||||||
|
|
||||||
Block Storage driver installation and deployment
|
Hypermetro consistency group
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
- OceanStor V3 V3R3C00
|
||||||
|
|
||||||
#. Before installation, delete all the installation files of Huawei OpenStack
|
OceanStor 2600V3 V3R5C00
|
||||||
Driver. The default path may be:
|
|
||||||
``/usr/lib/python2.7/disk-packages/cinder/volume/drivers/huawei``.
|
|
||||||
|
|
||||||
.. note::
|
OceanStor 18500/18800 V3R3C00
|
||||||
|
|
||||||
In this example, the version of Python is 2.7. If another version is
|
|
||||||
used, make corresponding changes to the driver path.
|
|
||||||
|
|
||||||
#. Copy `the Block Storage driver
|
|
||||||
<https://git.openstack.org/cgit/openstack/cinder/tree/cinder/volume/drivers/huawei?h=stable/newton>`_
|
|
||||||
to the Block Storage driver installation directory.
|
|
||||||
Refer to step 1 to find the default directory.
|
|
||||||
|
|
||||||
#. Refer to chapter :ref:`huawei-driver-configuration` to complete the
|
|
||||||
configuration.
|
|
||||||
|
|
||||||
#. After configuration, restart the ``cinder-volume`` service:
|
|
||||||
|
|
||||||
#. Check the status of services using the
|
|
||||||
:command:`openstack volume service list`
|
|
||||||
command. If the ``State`` of ``cinder-volume`` is ``up``, that means
|
|
||||||
``cinder-volume`` is okay.
|
|
||||||
|
|
||||||
.. code-block:: console
|
|
||||||
|
|
||||||
# openstack volume service list
|
|
||||||
+------------------+-----------------+------+---------+-------+----------------------------+
|
|
||||||
| Binary | Host | Zone | Status | State | Updated At |
|
|
||||||
+------------------+-----------------+------+---------+-------+----------------------------+
|
|
||||||
| cinder-scheduler | controller | nova | enabled | up | 2017-01-03T11:53:30.000000 |
|
|
||||||
| cinder-volume | controller@v3r3 | nova | enabled | up | 2017-01-03T11:53:34.000000 |
|
|
||||||
+------------------+-----------------+------+---------+-------+----------------------------+
|
|
||||||
|
|
||||||
.. _huawei-driver-configuration:
|
|
||||||
|
|
||||||
Volume driver configuration
|
Volume driver configuration
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
@ -148,19 +127,16 @@ To configure the volume driver, follow the steps below:
|
||||||
<config>
|
<config>
|
||||||
<Storage>
|
<Storage>
|
||||||
<Product>PRODUCT</Product>
|
<Product>PRODUCT</Product>
|
||||||
<Protocol>iSCSI</Protocol>
|
<Protocol>PROTOCOL</Protocol>
|
||||||
<ControllerIP1>x.x.x.x</ControllerIP1>
|
|
||||||
<UserName>xxxxxxxx</UserName>
|
<UserName>xxxxxxxx</UserName>
|
||||||
<UserPassword>xxxxxxxx</UserPassword>
|
<UserPassword>xxxxxxxx</UserPassword>
|
||||||
|
<RestURL>https://x.x.x.x:8088/deviceManager/rest/</RestURL>
|
||||||
</Storage>
|
</Storage>
|
||||||
<LUN>
|
<LUN>
|
||||||
<LUNType>xxx</LUNType>
|
<LUNType>xxx</LUNType>
|
||||||
<StripUnitSize>xxx</StripUnitSize>
|
|
||||||
<WriteType>xxx</WriteType>
|
<WriteType>xxx</WriteType>
|
||||||
<MirrorSwitch>xxx</MirrorSwitch>
|
|
||||||
<Prefetch Type="xxx" Value="xxx" />
|
<Prefetch Type="xxx" Value="xxx" />
|
||||||
<StoragePool Name="xxx" />
|
<StoragePool>xxx</StoragePool>
|
||||||
<StoragePool Name="xxx" />
|
|
||||||
</LUN>
|
</LUN>
|
||||||
<iSCSI>
|
<iSCSI>
|
||||||
<DefaultTargetIP>x.x.x.x</DefaultTargetIP>
|
<DefaultTargetIP>x.x.x.x</DefaultTargetIP>
|
||||||
|
|
@ -190,6 +166,12 @@ To configure the volume driver, follow the steps below:
|
||||||
|
|
||||||
<Product>18000</Product>
|
<Product>18000</Product>
|
||||||
|
|
||||||
|
* **For OceanStor Dorado series**
|
||||||
|
|
||||||
|
.. code-block:: xml
|
||||||
|
|
||||||
|
<Product>Dorado</Product>
|
||||||
|
|
||||||
The ``Protocol`` value to be used is ``iSCSI`` for iSCSI and ``FC`` for
|
The ``Protocol`` value to be used is ``iSCSI`` for iSCSI and ``FC`` for
|
||||||
Fibre Channel as shown below:
|
Fibre Channel as shown below:
|
||||||
|
|
||||||
|
|
@ -208,31 +190,67 @@ To configure the volume driver, follow the steps below:
|
||||||
|
|
||||||
#. Configure the ``cinder.conf`` file.
|
#. Configure the ``cinder.conf`` file.
|
||||||
|
|
||||||
In the ``[default]`` block of ``/etc/cinder/cinder.conf``, add the following
|
In the ``[default]`` block of ``/etc/cinder/cinder.conf``,
|
||||||
contents:
|
enable the ``VOLUME_BACKEND``:
|
||||||
|
|
||||||
|
.. code-block:: ini
|
||||||
|
|
||||||
|
enabled_backends = VOLUME_BACKEND
|
||||||
|
|
||||||
|
|
||||||
|
Add a new block ``[VOLUME_BACKEND]``, and add the following contents:
|
||||||
|
|
||||||
|
.. code-block:: ini
|
||||||
|
|
||||||
|
[VOLUME_BACKEND]
|
||||||
|
volume_driver = VOLUME_DRIVER
|
||||||
|
cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf.xml
|
||||||
|
volume_backend_name = Huawei_Storage
|
||||||
|
|
||||||
* ``volume_driver`` indicates the loaded driver.
|
* ``volume_driver`` indicates the loaded driver.
|
||||||
|
|
||||||
* ``cinder_huawei_conf_file`` indicates the specified Huawei-customized
|
* ``cinder_huawei_conf_file`` indicates the specified Huawei-customized
|
||||||
configuration file.
|
configuration file.
|
||||||
|
|
||||||
* ``hypermetro_devices`` indicates the list of remote storage devices for
|
* ``volume_backend_name`` indicates the name of the backend.
|
||||||
which Hypermetro is to be used.
|
|
||||||
|
|
||||||
The added content in the ``[default]`` block of ``/etc/cinder/cinder.conf``
|
Add information about remote devices in ``/etc/cinder/cinder.conf``
|
||||||
with the appropriate ``volume_driver`` and the list of
|
in target backend block for ``Hypermetro``.
|
||||||
``remote storage devices`` values for each product is as below:
|
|
||||||
|
|
||||||
.. code-block:: ini
|
.. code-block:: ini
|
||||||
|
|
||||||
|
[VOLUME_BACKEND]
|
||||||
volume_driver = VOLUME_DRIVER
|
volume_driver = VOLUME_DRIVER
|
||||||
cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf.xml
|
cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf.xml
|
||||||
hypermetro_devices = {STORAGE_DEVICE1, STORAGE_DEVICE2....}
|
volume_backend_name = Huawei_Storage
|
||||||
|
metro_san_user = xxx
|
||||||
|
metro_san_password = xxx
|
||||||
|
metro_domain_name = xxx
|
||||||
|
metro_san_address = https://x.x.x.x:8088/deviceManager/rest/
|
||||||
|
metro_storage_pools = xxx
|
||||||
|
|
||||||
|
Add information about remote devices in ``/etc/cinder/cinder.conf``
|
||||||
|
in target backend block for ``Replication``.
|
||||||
|
|
||||||
|
.. code-block:: ini
|
||||||
|
|
||||||
|
[VOLUME_BACKEND]
|
||||||
|
volume_driver = VOLUME_DRIVER
|
||||||
|
cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf.xml
|
||||||
|
volume_backend_name = Huawei_Storage
|
||||||
|
replication_device =
|
||||||
|
backend_id: xxx,
|
||||||
|
storage_pool :xxx,
|
||||||
|
san_address: https://x.x.x.x:8088/deviceManager/rest/,
|
||||||
|
san_user: xxx,
|
||||||
|
san_passowrd: xxx,
|
||||||
|
iscsi_default_target_ip: x.x.x.x
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
By default, the value for ``hypermetro_devices`` is ``None``.
|
By default, the value for ``Hypermetro`` and ``Replication`` is
|
||||||
|
``None``. For details about the parameters in the configuration file,
|
||||||
|
see the `Configuration file parameters`_ section.
|
||||||
|
|
||||||
The ``volume-driver`` value for every product is as below:
|
The ``volume-driver`` value for every product is as below:
|
||||||
|
|
||||||
|
|
@ -252,16 +270,6 @@ Configuring iSCSI Multipathing
|
||||||
|
|
||||||
To configure iSCSI Multipathing, follow the steps below:
|
To configure iSCSI Multipathing, follow the steps below:
|
||||||
|
|
||||||
#. Create a port group on the storage device using the ``DeviceManager`` and add
|
|
||||||
service links that require multipathing into the port group.
|
|
||||||
|
|
||||||
#. Log in to the storage device using CLI commands and enable the multiport
|
|
||||||
discovery switch in the multipathing.
|
|
||||||
|
|
||||||
.. code-block:: console
|
|
||||||
|
|
||||||
developer:/>change iscsi discover_multiport switch=on
|
|
||||||
|
|
||||||
#. Add the port group settings in the Huawei-customized driver configuration
|
#. Add the port group settings in the Huawei-customized driver configuration
|
||||||
file and configure the port group name needed by an initiator.
|
file and configure the port group name needed by an initiator.
|
||||||
|
|
||||||
|
|
@ -274,7 +282,20 @@ To configure iSCSI Multipathing, follow the steps below:
|
||||||
|
|
||||||
#. Enable the multipathing switch of the Compute service module.
|
#. Enable the multipathing switch of the Compute service module.
|
||||||
|
|
||||||
Add ``iscsi_use_multipath = True`` in ``[libvirt]`` of
|
Add ``volume_use_multipath = True`` in ``[libvirt]`` of
|
||||||
|
``/etc/nova/nova.conf``.
|
||||||
|
|
||||||
|
#. Run the :command:`service nova-compute restart` command to restart the
|
||||||
|
``nova-compute`` service.
|
||||||
|
|
||||||
|
Configuring FC Multipathing
|
||||||
|
------------------------------
|
||||||
|
|
||||||
|
To configure FC Multipathing, follow the steps below:
|
||||||
|
|
||||||
|
#. Enable the multipathing switch of the Compute service module.
|
||||||
|
|
||||||
|
Add ``volume_use_multipath = True`` in ``[libvirt]`` of
|
||||||
``/etc/nova/nova.conf``.
|
``/etc/nova/nova.conf``.
|
||||||
|
|
||||||
#. Run the :command:`service nova-compute restart` command to restart the
|
#. Run the :command:`service nova-compute restart` command to restart the
|
||||||
|
|
@ -310,13 +331,13 @@ Multiple storage systems configuration example:
|
||||||
|
|
||||||
enabled_backends = v3_fc, 18000_fc
|
enabled_backends = v3_fc, 18000_fc
|
||||||
[v3_fc]
|
[v3_fc]
|
||||||
volume_driver = cinder.volume.drivers.huawei.huawei_t.HuaweiFCDriver
|
volume_driver = cinder.volume.drivers.huawei.huawei_driver.HuaweiFCDriver
|
||||||
cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf_v3_fc.xml
|
cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf_v3_fc.xml
|
||||||
volume_backend_name = HuaweiTFCDriver
|
volume_backend_name = huawei_v3_fc
|
||||||
[18000_fc]
|
[18000_fc]
|
||||||
volume_driver = cinder.volume.drivers.huawei.huawei_driver.HuaweiFCDriver
|
volume_driver = cinder.volume.drivers.huawei.huawei_driver.HuaweiFCDriver
|
||||||
cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf_18000_fc.xml
|
cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf_18000_fc.xml
|
||||||
volume_backend_name = HuaweiFCDriver
|
volume_backend_name = huawei_18000_fc
|
||||||
|
|
||||||
Configuration file parameters
|
Configuration file parameters
|
||||||
-----------------------------
|
-----------------------------
|
||||||
|
|
@ -350,9 +371,7 @@ of the Huawei volume driver.
|
||||||
and V2 and V3 requires you to add port number ``8088``, for example,
|
and V2 and V3 requires you to add port number ``8088``, for example,
|
||||||
``https://x.x.x.x:8088/deviceManager/rest/``. If you need to configure
|
``https://x.x.x.x:8088/deviceManager/rest/``. If you need to configure
|
||||||
multiple RestURL, separate them by semicolons (;).
|
multiple RestURL, separate them by semicolons (;).
|
||||||
- T series V2
|
- All
|
||||||
|
|
||||||
V3 18000
|
|
||||||
* - UserName
|
* - UserName
|
||||||
- ``-``
|
- ``-``
|
||||||
- User name of a storage administrator.
|
- User name of a storage administrator.
|
||||||
|
|
@ -380,33 +399,24 @@ of the Huawei volume driver.
|
||||||
- Description
|
- Description
|
||||||
- Applicable to
|
- Applicable to
|
||||||
* - LUNType
|
* - LUNType
|
||||||
- Thin
|
- Thick
|
||||||
- Type of the LUNs to be created. The value can be ``Thick`` or ``Thin``.
|
- Type of the LUNs to be created. The value can be ``Thick`` or ``Thin``. Dorado series only support ``Thin`` LUNs.
|
||||||
- All
|
- All
|
||||||
* - WriteType
|
* - WriteType
|
||||||
- 1
|
- 1
|
||||||
- Cache write type, possible values are: ``1`` (write back), ``2``
|
- Cache write type, possible values are: ``1`` (write back), ``2``
|
||||||
(write through), and ``3`` (mandatory write back).
|
(write through), and ``3`` (mandatory write back).
|
||||||
- All
|
- All
|
||||||
* - MirrorSwitch
|
|
||||||
- 1
|
|
||||||
- Cache mirroring or not, possible values are: ``0`` (without mirroring)
|
|
||||||
or ``1`` (with mirroring).
|
|
||||||
- All
|
|
||||||
* - LUNcopyWaitInterval
|
* - LUNcopyWaitInterval
|
||||||
- 5
|
- 5
|
||||||
- After LUN copy is enabled, the plug-in frequently queries the copy
|
- After LUN copy is enabled, the plug-in frequently queries the copy
|
||||||
progress. You can set a value to specify the query interval.
|
progress. You can set a value to specify the query interval.
|
||||||
- T series V2 V3
|
- All
|
||||||
|
|
||||||
18000
|
|
||||||
* - Timeout
|
* - Timeout
|
||||||
- 432000
|
- 432000
|
||||||
- Timeout interval for waiting LUN copy of a storage device to complete.
|
- Timeout interval for waiting LUN copy of a storage device to complete.
|
||||||
The unit is second.
|
The unit is second.
|
||||||
- T series V2 V3
|
- All
|
||||||
|
|
||||||
18000
|
|
||||||
* - Initiator Name
|
* - Initiator Name
|
||||||
- ``-``
|
- ``-``
|
||||||
- Name of a compute node initiator.
|
- Name of a compute node initiator.
|
||||||
|
|
@ -419,9 +429,7 @@ of the Huawei volume driver.
|
||||||
- ``-``
|
- ``-``
|
||||||
- IP address of the iSCSI target port that is provided for compute
|
- IP address of the iSCSI target port that is provided for compute
|
||||||
nodes.
|
nodes.
|
||||||
- T series V2 V3
|
- All
|
||||||
|
|
||||||
18000
|
|
||||||
* - DefaultTargetIP
|
* - DefaultTargetIP
|
||||||
- ``-``
|
- ``-``
|
||||||
- Default IP address of the iSCSI target port that is provided for
|
- Default IP address of the iSCSI target port that is provided for
|
||||||
|
|
@ -435,7 +443,50 @@ of the Huawei volume driver.
|
||||||
- ``-``
|
- ``-``
|
||||||
- IP address of the Nova compute node's host.
|
- IP address of the Nova compute node's host.
|
||||||
- All
|
- All
|
||||||
|
* - metro_san_user
|
||||||
|
- ``-``
|
||||||
|
- User name of a storage administrator of hypermetro remote device.
|
||||||
|
- V3R3/2600 V3R5/18000 V3R3
|
||||||
|
* - metro_san_password
|
||||||
|
- ``-``
|
||||||
|
- Password of a storage administrator of hypermetro remote device.
|
||||||
|
- V3R3/2600 V3R5/18000 V3R3
|
||||||
|
* - metro_domain_name
|
||||||
|
- ``-``
|
||||||
|
- Hypermetro domain name configured on ISM.
|
||||||
|
- V3R3/2600 V3R5/18000 V3R3
|
||||||
|
* - metro_san_address
|
||||||
|
- ``-``
|
||||||
|
- Access address of the REST interface, https://x.x.x.x/devicemanager/rest/. The value x.x.x.x indicates the management IP address.
|
||||||
|
- V3R3/2600 V3R5/18000 V3R3
|
||||||
|
* - metro_storage_pools
|
||||||
|
- ``-``
|
||||||
|
- Remote storage pool for hypermetro.
|
||||||
|
- V3R3/2600 V3R5/18000 V3R3
|
||||||
|
* - backend_id
|
||||||
|
- ``-``
|
||||||
|
- Target device ID.
|
||||||
|
- All
|
||||||
|
* - storage_pool
|
||||||
|
- ``-``
|
||||||
|
- Pool name of target backend when failover for replication.
|
||||||
|
- All
|
||||||
|
* - san_address
|
||||||
|
- ``-``
|
||||||
|
- Access address of the REST interface, https://x.x.x.x/devicemanager/rest/. The value x.x.x.x indicates the management IP address.
|
||||||
|
- All
|
||||||
|
* - san_user
|
||||||
|
- ``-``
|
||||||
|
- User name of a storage administrator of replication remote device.
|
||||||
|
- All
|
||||||
|
* - san_password
|
||||||
|
- ``-``
|
||||||
|
- Password of a storage administrator of replication remote device.
|
||||||
|
- All
|
||||||
|
* - iscsi_default_target_ip
|
||||||
|
- ``-``
|
||||||
|
- Remote transacton port IP.
|
||||||
|
- All
|
||||||
.. important::
|
.. important::
|
||||||
|
|
||||||
The ``Initiator Name``, ``Initiator TargetIP``, and
|
The ``Initiator Name``, ``Initiator TargetIP``, and
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,5 @@
|
||||||
|
---
|
||||||
|
fixes:
|
||||||
|
Update Huawei cinder driver configuration.
|
||||||
|
1.Remove the redundant configuration.
|
||||||
|
2.Add new features and storage system that Huawei cinder driver support.
|
||||||
Loading…
Reference in New Issue