zhangyanxian 39d4d48d25 Add new version info for the huawei-storage-driver.rst

Change-Id: I3cd56e1b90c3dd567d4d81631709b37a65a27ed9

2016-09-28 03:12:59 +00:00

13 KiB

Raw Blame History

Huawei volume driver

Huawei volume driver can be used to provide functions such as the logical volume and snapshot for virtual machines (VMs) in the OpenStack Block Storage driver that supports iSCSI and Fibre Channel protocols.

Version mappings

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

**Version mappings among the Block Storage driver and Huawei storage system**
Description	Storage System Version
Create, delete, expand, attach, detach, manage, and unmanage volumes. Create, delete, manage, unmanage, and backup a snapshot. Create, delete, and update a consistency group. Create and delete a cgsnapshot. Copy an image to a volume. Copy a volume to an image. Create a volume from a snapshot. Clone a volume. QoS	OceanStor T series V2R2 C00/C20/C30 OceanStor V3 V3R1C10/C20 V3R2C10 V3R3C00 OceanStor 2200V3 V300R005C00 OceanStor 2600V3 V300R005C00 OceanStor 18500/18800 V1R1C00/C20/C30 V3R3C00
Volume Migration Auto zoning SmartTier SmartCache Smart Thin/Thick Replication V2.1	OceanStor T series V2R2 C00/C20/C30 OceanStor V3 V3R1C10/C20 V3R2C10 V3R3C00 OceanStor 2200V3 V300R005C00 OceanStor 2600V3 V300R005C00 OceanStor 18500/18800V1R1C00/C20/C30
SmartPartition	OceanStor T series V2R2 C00/C20/C30 OceanStor V3 V3R1C10/C20 V3R2C10 V3R3C00 OceanStor 2600V3 V300R005C00 OceanStor 18500/18800V1R1C00/C20/C30

Block Storage driver installation and deployment

Before installation, delete all the installation files of Huawei OpenStack Driver. The default path may be: /usr/lib/python2.7/disk-packages/cinder/volume/drivers/huawei.

Note

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 to the Block Storage driver installation directory. Refer to step 1 to find the default directory.
Refer to chapter huawei-driver-configuration to complete the configuration.
After configuration, restart the cinder-volume service:

Check the status of services using the cinder service-list command. If the State of cinder-volume is up, that means cinder-volume is okay.

# cinder service-list
+-----------------+-----------------+------+---------+-------+----------------------------+-----------------+
| Binary          | Host            | Zone | Status  | State | Updated_at                 | Disabled Reason |
+-----------------+-----------------+------+---------+-------+----------------------------+-----------------+
| cinderscheduler | controller      | nova | enabled | up    | 2016-02-01T16:26:00.000000 | -               |
+-----------------+-----------------+------+---------+-------+----------------------------+-----------------+
| cindervolume    | controller@v3r3 | nova | enabled | up    | 2016-02-01T16:25:53.000000 | -               |
+-----------------+-----------------+------+---------+-------+----------------------------+-----------------+

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 in the [DEFAULT] configuration group of the /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:

In /etc/cinder, create a Huawei-customized driver configuration file. The file format is XML.
Change the name of the driver configuration file based on the site requirements, for example, cinder_huawei_conf.xml.

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>iSCSI</Protocol>
         <ControllerIP1>x.x.x.x</ControllerIP1>
         <UserName>xxxxxxxx</UserName>
         <UserPassword>xxxxxxxx</UserPassword>
      </Storage>
      <LUN>
         <LUNType>xxx</LUNType>
         <StripUnitSize>xxx</StripUnitSize>
         <WriteType>xxx</WriteType>
         <MirrorSwitch>xxx</MirrorSwitch>
         <Prefetch Type="xxx" Value="xxx" />
         <StoragePool Name="xxx" />
         <StoragePool Name="xxx" />
      </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>
```

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.

Configure the cinder.conf file.

In the [default] block of /etc/cinder/cinder.conf, add the following contents:
- volume_driver indicates the loaded driver.
- cinder_huawei_conf_file indicates the specified Huawei-customized configuration file.
- hypermetro_devices indicates the list of remote storage devices for which Hypermetro is to be used.
The added content in the [default] block of /etc/cinder/cinder.conf with the appropriate volume_driver and the list of remote storage devices values for each product is as below:
```
volume_driver = VOLUME_DRIVER
cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf.xml
hypermetro_devices = {STORAGE_DEVICE1, STORAGE_DEVICE2....}
```
Note

By default, the value for hypermetro_devices is None.

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
```
Run the service cinder-volume restart command to restart the Block Storage service.

Configuring iSCSI Multipathing

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.
```
developer:/>change iscsi discover_multiport switch=on
```
Add the port group settings in the Huawei-customized driver configuration file and configure the port group name needed by an initiator.
```
<iSCSI>
   <DefaultTargetIP>x.x.x.x</DefaultTargetIP>
   <Initiator Name="xxxxxx" TargetPortGroup="xxxx" />
</iSCSI>
```
Enable the multipathing switch of the Compute service module.

Add iscsi_use_multipath = True in [libvirt] of /etc/nova/nova.conf.
Run the service nova-compute restart command to restart the nova-compute service.

Configuring CHAP and ALUA

On a public network, any application server whose IP address resides on the same network segment as that of the storage systems iSCSI host port can access the storage system and perform read and write operations in it. This poses risks to the data security of the storage system. To ensure the storage systems access security, you can configure CHAP authentication to control application servers access to the storage system.

Adjust the driver configuration file as follows:

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

ALUA indicates a multipathing mode. 0 indicates that ALUA is disabled. 1 indicates that ALUA is enabled. CHAPinfo indicates the user name and password authenticated by CHAP. The format is mmuser; mm-user@storage. The user name and password are separated by semicolons (;).

Configuring multiple storage

Multiple storage systems configuration example:

enabled_backends = v3_fc, 18000_fc
[v3_fc]
volume_driver = cinder.volume.drivers.huawei.huawei_t.HuaweiFCDriver
cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf_v3_fc.xml
volume_backend_name = HuaweiTFCDriver
[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 = HuaweiFCDriver

Configuration file parameters

This section describes mandatory and optional configuration file parameters of the Huawei volume driver.

**Mandatory parameters**
Parameter	Default value	Description	Applicable to
Product	`-`	Type of a storage product. Possible values are `TV2`, `18000` and `V3`.	All
Protocol	`-`	Type of a connection protocol. The possible value is either `'iSCSI'` or `'FC'`.	All
RestURL	`-`	Access address of the REST interface, `https://x.x.x.x/devicemanager/rest/`. The value `x.x.x.x` indicates the management IP address. OceanStor 18000 uses the preceding setting, 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 multiple RestURL, separate them by semicolons (;).	T series V2 V3 18000
UserName	`-`	User name of a storage administrator.	All
UserPassword	`-`	Password of a storage administrator.	All
StoragePool	`-`	Name of a storage pool to be used. If you need to configure multiple storage pools, separate them by semicolons (`;`).	All