diff --git a/doc/config-reference/block-storage/drivers/huawei-storage-driver.xml b/doc/config-reference/block-storage/drivers/huawei-storage-driver.xml index addf49f66d..2a7c679b31 100644 --- a/doc/config-reference/block-storage/drivers/huawei-storage-driver.xml +++ b/doc/config-reference/block-storage/drivers/huawei-storage-driver.xml @@ -1,157 +1,86 @@ -
+
Huawei storage driver The Huawei driver supports the iSCSI and Fibre Channel connections and enables OceanStor T - series unified storage, OceanStor TV3 storage, and OceanStor 18000 high-end storage to + series V200R002, OceanStor 18000 series V100R001 and OceanStor V3 series V300R002 storage to provide block storage services for OpenStack. Supported operations - OceanStor T series unified storage supports these - operations: - - - Create, delete, attach, and detach volumes. - - - Create, list, and delete volume snapshots. - - - Create a volume from a snapshot. - - - Copy an image to a volume. - - - Copy a volume to an image. - - - Clone a volume. - - - OceanStor V3 supports these operations: - - - Create, delete, attach, and detach volumes. - - - Create, list, and delete volume snapshots. - - - Copy an image to a volume. - - - Copy a volume to an image. - - - Create a volume from a snapshot. - - - Clone a volume. - - - OceanStor 18000 supports these operations: - - - Create, delete, attach, and detach volumes. - - - Create, list, and delete volume snapshots. - - - Copy an image to a volume. - - - Copy a volume to an image. - - - Create a volume from a snapshot. - - - Clone a volume. - + + Create, delete, expand, attach, and detach volumes. + + + Create and delete a snapshot. + + + Copy an image to a volume. + + + Copy a volume to an image. + + + Create a volume from a snapshot. + + + Clone a volume. + - Configure Block Storage nodes - In /etc/cinder, create the driver - configuration file named - cinder_huawei_conf.xml. - You must configure and - to specify a storage system - and link type. The following uses the iSCSI driver as an - example. The driver configuration file of OceanStor T - series unified storage is shown as follows: - <?xml version='1.0' encoding='UTF-8'?> -<config> - <Storage> - <Product>T</Product> - <Protocol>iSCSI</Protocol> - <ControllerIP0>x.x.x.x</ControllerIP0> - <ControllerIP1>x.x.x.x</ControllerIP1> - <UserName>xxxxxxxx</UserName> - <UserPassword>xxxxxxxx</UserPassword> - </Storage> - <LUN> - <LUNType>Thick</LUNType> - <StripUnitSize>64</StripUnitSize> - <WriteType>1</WriteType> - <MirrorSwitch>1</MirrorSwitch> - <Prefetch Type="3" value="0"/> - <StoragePool Name="xxxxxxxx"/> - <StoragePool Name="xxxxxxxx"/> - </LUN> - <iSCSI> - <DefaultTargetIP>x.x.x.x</DefaultTargetIP> - <Initiator Name="xxxxxxxx" TargetIP="x.x.x.x"/> - <Initiator Name="xxxxxxxx" TargetIP="x.x.x.x"/> - </iSCSI> - <Host OSType="Linux" HostIP="x.x.x.x, x.x.x.x"/> -</config> - The driver configuration file of OceanStor V3 is - shown as follows: - <?xml version='1.0' encoding='UTF-8'?> -<config> - <Storage> - <Product>V3</Product> - <Protocol>iSCSI</Protocol> - <ControllerIP0>x.x.x.x</ControllerIP0> - <ControllerIP1>x.x.x.x</ControllerIP1> - <UserName>xxxxxxxx</UserName> - <UserPassword>xxxxxxxx</UserPassword> - </Storage> - <LUN> - <StripUnitSize>64</StripUnitSize> - <WriteType>1</WriteType> - <MirrorSwitch>1</MirrorSwitch> - <StoragePool Name="xxxxxxxx"/> - <StoragePool Name="xxxxxxxx"/> - </LUN> - <iSCSI> - <DefaultTargetIP>x.x.x.x</DefaultTargetIP> - <Initiator Name="xxxxxxxx" TargetIP="x.x.x.x"/> - <Initiator Name="xxxxxxxx" TargetIP="x.x.x.x"/> - </iSCSI> - <Host OSType="Linux" HostIP="x.x.x.x, x.x.x.x"/> -</config> - The driver configuration file of OceanStor 18000 is shown as follows: - - <?xml version='1.0' encoding='UTF-8'?> + Configure block storage nodes + + + Modify the cinder.conf configuration file and add + and . + + Example for configuring a storage system: + volume_driver = cinder.volume.drivers.huawei.HuaweiVolumeDriver +cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf.xml + + + + Example for configuring multiple storage systems: + enabled_backends = t_iscsi, 18000_iscsi +[t_iscsi] +volume_driver = cinder.volume.drivers.huawei.HuaweiVolumeDriver +cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf_t_iscsi.xml +volume_backend_name = HuaweiTISCSIDriver + +[18000_iscsi] +volume_driver = cinder.volume.drivers.huawei.HuaweiVolumeDriver +cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf_18000_iscsi.xml +volume_backend_name = Huawei18000ISCSIDriver + + + + + In /etc/cinder, create a driver configuration file. The + driver configuration file name must be the same as the cinder_huawei_conf_file + item in the cinder_conf configuration file. + + + Configure product and protocol. + Product and Protocol indicate the storage system type and link type + respectively. For the OceanStor 18000 series V100R001 storage systems, the + driver configuration file is as follows: + <?xml version='1.0' encoding='UTF-8'?> <config> <Storage> <Product>18000</Product> <Protocol>iSCSI</Protocol> - <RestURL>https://x.x.x.x:8088/deviceManager/rest/</RestURL> + <RestURL>https://x.x.x.x/deviceManager/rest/</RestURL> <UserName>xxxxxxxx</UserName> <UserPassword>xxxxxxxx</UserPassword> </Storage> <LUN> <LUNType>Thick</LUNType> <WriteType>1</WriteType> - <MirrorSwitch>1</MirrorSwitch> + <MirrorSwitch>0</MirrorSwitch> + <LUNcopyWaitInterval>5</LUNcopyWaitInterval> + <Timeout>432000</Timeout> <StoragePool>xxxxxxxx</StoragePool> </LUN> <iSCSI> @@ -161,339 +90,308 @@ </iSCSI> <Host OSType="Linux" HostIP="x.x.x.x, x.x.x.x"/> </config> - - Note for Fibre Channel driver configuration - You do not need to configure the iSCSI target IP - address for the Fibre Channel driver. In the prior - example, delete the iSCSI configuration: - - - <iSCSI> + + + + Note for fibre channel driver configuration + + In the configuration files of OceanStor T series V200R002 and + OceanStor V3 V300R002, parameter configurations are the same + with the exception of the RestURL parameter. The following + describes how to configure the RestURL parameter: + <RestURL>https://x.x.x.x:8088/deviceManager/rest/</RestURL> + + + + + For a Fibre Channel driver, you do not need to configure an + iSCSI target IP address. Delete the iSCSI configuration from the + preceding examples. + <iSCSI> <DefaultTargetIP>x.x.x.x</DefaultTargetIP> <Initiator Name="xxxxxxxx" TargetIP="x.x.x.x"/> <Initiator Name="xxxxxxxx" TargetIP="x.x.x.x"/> - </iSCSI> - To add and - items, you - can modify the cinder.conf - configuration file as follows: - volume_driver = cinder.volume.drivers.huawei.HuaweiVolumeDriver -cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf.xml - You can configure multiple Huawei back-end storages as - follows: - enabled_backends = t_iscsi, 18000_iscsi -[t_iscsi] -volume_driver = cinder.volume.drivers.huawei.HuaweiVolumeDriver -cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf_t_iscsi.xml -volume_backend_name = HuaweiTISCSIDriver -[18000_iscsi] -volume_driver = cinder.volume.drivers.huawei.HuaweiVolumeDriver -cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf_18000_iscsi.xml -volume_backend_name = Huawei18000ISCSIDriver - - - Configuration file details - This table describes the Huawei storage driver - configuration options: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Huawei storage driver configuration - options
Flag nameTypeDefaultDescription
- - - Required - - - - Type of a storage product. Valid values - are T, - TV3, or 18000. -
Required - - Type of a protocol. Valid values are - iSCSI or - FC. -
Required - - IP address of the primary controller (not - required for the 18000)
- - - Required - - - - IP address of the secondary controller - (not required for the 18000) -
Required - - Access address of the Rest port (required only - for the 18000)
- - - Required - - - - User name of an administrator -
- - - - Required - - - - Password of an administrator -
- - - Optional - - Thin - - Type of a created LUN. Valid values are - Thick or - Thin. -
- - - - Optional - - 64 - - Stripe depth of a created LUN. The value - is expressed in KB. - This flag is not valid for a thin - LUN. -
- - - - Optional - - 1 - - Cache write method. The method can be - write back, write through, or Required - write back. The default value is - 1, indicating write - back. -
- - - Optional - - 1 - - Cache mirroring policy. The default - value is 1, indicating - that a mirroring policy is used. -
Optional - 3 - - Cache prefetch strategy. The strategy - can be constant prefetch, variable - prefetch, or intelligent prefetch. Default - value is 3, which - indicates intelligent prefetch and is not - required for the 18000. -
Optional - 0 - - Cache prefetch value. -
Required - - - Name of a storage pool that you want to use. -
Optional - - - Default IP address of the iSCSI port - provided for compute nodes. -
Optional - - - Name of a compute node initiator. -
Optional - - - IP address of the iSCSI port provided - for compute nodes. -
Optional - Linux - The OS type for a compute node.
Optional - - The IPs for compute nodes.
- - Note for the configuration - - - You can configure one iSCSI target port for - each or all compute nodes. The driver checks - whether a target port IP address is configured - for the current compute node. If not, select - . - - - You can configure multiple storage pools in - one configuration file, which supports the use - of multiple storage pools in a storage system. - (The 18000 driver allows configuration of only - one storage pool.) - - - For details about LUN configuration - information, see the - createlun command in - the command-line interface (CLI) documentation - or run the help -c - createlun on the storage system - CLI. - - - After the driver is loaded, the storage - system obtains any modification of the driver - configuration file in real time and you do not - need to restart the cinder-volume - service. - - - The driver does not support the - iSCSI multipath scenarios. - - - +</iSCSI> + + + + + This table describes the Huawei storage driver configuration options: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Huawei storage driver configuration options
PropertyTypeDefaultDescription
+ + + Mandatory + + - + + Type of a storage product. Valid values are + T, TV3, or + 18000. +
Mandatory + - + Type of a protocol. Valid values are iSCSI or + FC. +
Mandatory + - + Access address of the Rest port (required only for the 18000)
+ + + Mandatory + + - + + User name of an administrator +
+ + + + Mandatory + + - + + Password of an administrator +
+ + + Optional + + Thin + + Type of a created LUN. Valid values are + Thick or Thin. +
+ + + + Optional + + 64 + + Stripe depth of a created LUN. The value is expressed in + KB. + This flag is not valid for a thin LUN. +
+ + + + Optional + + 1 + + Cache write method. The method can be write back, write + through, or Required write back. The default value is + 1, indicating write back. +
+ + + Optional + + 1 + + Cache mirroring policy. The default value is + 1, indicating that a mirroring policy is + used. +
Optional + 3 + + Cache prefetch strategy. The strategy can be constant + prefetch, variable prefetch, or intelligent prefetch. Default + value is 3, which indicates intelligent + prefetch and is not required for the OceanStor 18000 series. +
Optional + 0 + + Cache prefetch value. +
Optional + 5 + + After LUN copy is enabled, the plug-in frequently queries the + copy progress. You can set a value to specify the query + interval. +
Optional + 432,000 + + Timeout period for waiting LUN copy of an array to + complete. +
Mandatory + - + + Name of a storage pool that you want to use. +
Optional + - + + Default IP address of the iSCSI port provided for compute + nodes. +
Optional + - + + Name of a compute node initiator. +
Optional + - + + IP address of the iSCSI port provided for compute + nodes. +
Optional + Linux + The OS type for a compute node.
Optional + - + The IPs for compute nodes.
+ + Note for the configuration + + + You can configure one iSCSI target port for each or all compute + nodes. The driver checks whether a target port IP address is + configured for the current compute node. If not, select + . + + + Only one storage pool can be configured. + + + For details about LUN configuration information, see the + show lun general command in the command-line + interface (CLI) documentation or run the help -c show lun + general on the storage system CLI. + + + After the driver is loaded, the storage system obtains any + modification of the driver configuration file in real time and you + do not need to restart the cinder-volume service. + + + + + + Restart the Cinder service. + +