Huawei volume driver¶

Version mappings¶

The following table describes the version mappings among the Block Storage driver, Huawei storage system and OpenStack:

Volume driver configuration¶

This section describes how to configure the Huawei volume driver for either iSCSI storage or Fibre Channel storage.

Pre-requisites

When creating a volume from image, install the multipath tool and add the following configuration keys for each backend section or in [backend_defaults] section as a common configuration for all backends in /etc/cinder/cinder.conf file:

use_multipath_for_image_xfer = True
enforce_multipath_for_image_xfer = True

To configure the volume driver, follow the steps below:

1. In /etc/cinder, create a Huawei-customized driver configuration file. The file format is XML.

2. Change the name of the driver configuration file based on the site requirements, for example, cinder_huawei_conf.xml.

3. Configure parameters in the driver configuration file.

   Each product has its own value for the Product parameter under the Storage xml block. The full xml file with the appropriate Product parameter is as below:

     <?xml version="1.0" encoding="UTF-8"?>
        <config>
           <Storage>
              <Product>PRODUCT</Product>
              <Protocol>PROTOCOL</Protocol>
              <UserName>xxxxxxxx</UserName>
              <UserPassword>xxxxxxxx</UserPassword>
              <RestURL>https://x.x.x.x:8088/deviceManager/rest/</RestURL>
           </Storage>
           <LUN>
              <LUNType>xxx</LUNType>
              <WriteType>xxx</WriteType>
              <Prefetch Type="xxx" Value="xxx" />
              <StoragePool>xxx</StoragePool>
           </LUN>
           <iSCSI>
              <DefaultTargetIP>x.x.x.x</DefaultTargetIP>
              <Initiator Name="xxxxxxxx" TargetIP="x.x.x.x"/>
           </iSCSI>
           <Host OSType="Linux" HostIP="x.x.x.x, x.x.x.x"/>
        </config>
   
   The corresponding ``Product`` values for each product are as below:
   

   • For T series V2

     <Product>TV2</Product>
     

   • For V3

     <Product>V3</Product>
     

   • For OceanStor 18000 series

     <Product>18000</Product>
     

   • For OceanStor Dorado series

     <Product>Dorado</Product>
     

   The Protocol value to be used is iSCSI for iSCSI and FC for Fibre Channel as shown below:

   # For iSCSI
   <Protocol>iSCSI</Protocol>
   
   # For Fibre channel
   <Protocol>FC</Protocol>
   

   Note

   For details about the parameters in the configuration file, see the Configuration file parameters section.

4. Configure the cinder.conf file.

   In the [default] block of /etc/cinder/cinder.conf, enable the VOLUME_BACKEND:

   enabled_backends = VOLUME_BACKEND
   

   Add a new block [VOLUME_BACKEND], and add the following contents:

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

   • cinder_huawei_conf_file indicates the specified Huawei-customized configuration file.

   • volume_backend_name indicates the name of the backend.

   Add information about remote devices in /etc/cinder/cinder.conf in target backend block for Hypermetro.

   [VOLUME_BACKEND]
   volume_driver = VOLUME_DRIVER
   cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf.xml
   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.

   [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_password: xxx,
       iscsi_default_target_ip: x.x.x.x
   

   Note

   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:

   # For iSCSI
   volume_driver = cinder.volume.drivers.huawei.huawei_driver.HuaweiISCSIDriver
   
   # For FC
   volume_driver = cinder.volume.drivers.huawei.huawei_driver.HuaweiFCDriver
   

5. Run the service cinder-volume restart command to restart the Block Storage service.

<Initiator ALUA="xxx" CHAPinfo="xxx" Name="xxx" TargetIP="x.x.x.x"/>

enabled_backends = v3_fc, 18000_fc
[v3_fc]
volume_driver = cinder.volume.drivers.huawei.huawei_driver.HuaweiFCDriver
cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf_v3_fc.xml
volume_backend_name = huawei_v3_fc
[18000_fc]
volume_driver = cinder.volume.drivers.huawei.huawei_driver.HuaweiFCDriver
cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf_18000_fc.xml
volume_backend_name = huawei_18000_fc