From edcb505aec930d8f373395c6c1aac48487faadd1 Mon Sep 17 00:00:00 2001 From: zhangchao010 Date: Mon, 14 Oct 2013 16:33:41 +0800 Subject: [PATCH] Update document for Huawei cinder volume driver Huawei FC driver and HVS storage system driver were merged into Havana. So this patch updates configuration guide for the changes. Closes-bug: 1232657 Change-Id: Icc15073bf6195abc55aa3d24a08d878ff6aa94d9 --- .../drivers/huawei-storage-driver.xml | 395 +++++++++++++----- 1 file changed, 283 insertions(+), 112 deletions(-) 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 caddacbb0c..a00cdb86b1 100644 --- a/doc/config-reference/block-storage/drivers/huawei-storage-driver.xml +++ b/doc/config-reference/block-storage/drivers/huawei-storage-driver.xml @@ -5,77 +5,132 @@ xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="huawei-storage-driver"> Huawei Storage Driver - Huawei storage drivers integrate OceanStor T series unified storage with OceanStor - Dorado high-performance storage to provide block storage services for - OpenStack. + Huawei driver supports the iSCSI and Fibre Channel connections and enables + OceanStor T series unified storage, OceanStor Dorado high-performance storage, and OceanStor + HVS high-end storage to provide block storage services for OpenStack. - Supported Operations - OceanStor T series unified storage supports the following operations: - - Create volume - - - Delete volume - - - Attach volume - - - Detach volume - - - Create snapshot - - - Delete snapshot - - - Create volume from snapshot - - OceanStor Dorado5100 supports the following operations : - - Create volume - - - Delete volume - - - Attach volume - - - Detach volume - - - Create snapshot - - - Delete snapshot - - OceanStor Dorado2100 G2 supports the following operations : - - Create volume - - - Delete volume - - - Attach volume - - - Detach volume - - - + Supported Operations + OceanStor T series unified storage supports the following operations: + + Create volume + + + Delete volume + + + Attach volume + + + Detach volume + + + Create snapshot + + + Delete snapshot + + + Create volume from snapshot + + + Create clone volume + + + Copy image to volume + + + Copy volume to image + + OceanStor Dorado5100 supports the following operations : + + Create volume + + + Delete volume + + + Attach volume + + + Detach volume + + + Create snapshot + + + Delete snapshot + + + Copy image to volume + + + Copy volume to image + + OceanStor Dorado2100 G2 supports the following operations : + + Create volume + + + Delete volume + + + Attach volume + + + Detach volume + + + Copy image to volume + + + Copy volume to image + + OceanStor HVS supports the following operations: + + Create volume + + + Delete volume + + + Attach volume + + + Detach volume + + + Create snapshot + + + Delete snapshot + + + Create volume from snapshot + + + Create clone volume + + + Copy image to volume + + + Copy volume to image + + + Configuring Cinder Nodes In /etc/cinder, create the driver configuration file named cinder_huawei_conf.xml. - For OceanStor T series unified storage, the driver configuration file is shown - as follows: - -<?xml version='1.0' encoding='UTF-8'?> + You need to configure Product and + Protocol 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> @@ -95,14 +150,15 @@ <Initiator Name="xxxxxxxx" TargetIP="x.x.x.x"/> <Initiator Name="xxxxxxxx" TargetIP="x.x.x.x"/> </iSCSI> -</config> - - For OceanStor Dorado5100, the driver configuration file is shown as - follows: - -<?xml version='1.0' encoding='UTF-8'?> + <Host OSType=”Linux” HostIP=”x.x.x.x, x.x.x.x”/> +</config> + The driver configuration file of OceanStor Dorado5100 is shown as + follows: + <?xml version='1.0' encoding='UTF-8'?> <config> <Storage> + <Product>Dorado</Product> + <Protocol>iSCSI</Protocol> <ControllerIP0>x.x.x.x</ControllerIP0> <ControllerIP1>x.x.x.x</ControllerIP1> <UserName>xxxxxxxx</UserName> @@ -120,14 +176,15 @@ <Initiator Name="xxxxxxxx" TargetIP="x.x.x.x"/> <Initiator Name="xxxxxxxx" TargetIP="x.x.x.x"/> </iSCSI> -</config> - - For OceanStor Dorado2100 G2, the driver configuration file is shown as - follows: - -<?xml version='1.0' encoding='UTF-8'?> + <Host OSType=”Linux” HostIP=”x.x.x.x, x.x.x.x”/> +</config> + The driver configuration file of OceanStor Dorado2100 G2 is shown as + follows: + <?xml version='1.0' encoding='UTF-8'?> <config> <Storage> + <Product>Dorado</Product> + <Protocol>iSCSI</Protocol> <ControllerIP0>x.x.x.x</ControllerIP0> <ControllerIP1>x.x.x.x</ControllerIP1> <UserName>xxxxxxxx</UserName> @@ -143,25 +200,90 @@ <Initiator Name="xxxxxxxx" TargetIP="x.x.x.x"/> <Initiator Name="xxxxxxxx" TargetIP="x.x.x.x"/> </iSCSI> -</config> - - To add volume-driver and - cinder_huawei_conf_file items, you can modify - configuration file cinder.conf as follows: - -volume_driver = cinder.volume.drivers.huawei.huawei_iscsi.HuaweiISCSIDriver -cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf.xml - - + <Host OSType=”Linux” HostIP=”x.x.x.x, x.x.x.x”/> +</config> + The driver configuration file of OceanStor HVS is shown as follows: + + <?xml version='1.0' encoding='UTF-8'?> +<config> + <Storage> + <Product>HVS</Product> + <Protocol>iSCSI</Protocol> + <HVSURL>https://x.x.x.x:8088/deviceManager/rest/</HVSURL> + <UserName>xxxxxxxx</UserName> + <UserPassword>xxxxxxxx</UserPassword> + </Storage> + <LUN> + <LUNType>Thick</LUNType> + <WriteType>1</WriteType> + <MirrorSwitch>1</MirrorSwitch> + <StoragePool>xxxxxxxx</StoragePool> + </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> + + 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> + <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 volume_driver and cinder_huawei_conf_file + items, you can modify configuration file cinder.conf 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, dorado5100_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 +[dorado5100_iscsi] +volume_driver = cinder.volume.drivers.huawei.HuaweiVolumeDriver +cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf_dorado5100_iscsi.xml +volume_backend_name = HuaweiDorado5100ISCSIDriver + OceanStor HVS storage system supports the QoS function. You need to create a QoS + policy for the HVS storage system and create the volume type to enable QoS as follows: + Create volume type: QoS_high +cinder type-create QoS_high +Configure extra_specs for QoS_high: +cinder type-key QoS_high set capabilities:QoS_support="<is> True" drivers:flow_strategy=OpenStack_QoS_high drivers:io_priority=high + + OpenStack_QoS_high is a QoS policy created by a user for the + HVS storage system. QoS_high is the self-defined volume type. + io_priority can only be set to high, + normal, or low. + + OceanStor HVS storage system supports the SmartTier function. SmartTier has three + tiers. You can create the volume type to enable SmartTier as follows: + Create volume type: Tier_high +cinder type-create Tier_high +Configure extra_specs for Tier_high: +cinder type-key Tier_high set capabilities:Tier_support="<is> True" drivers:distribute_policy=high drivers:transfer_strategy=high + + distribute_policy and transfer_strategy can + only be set to high, normal, or + low. + Configuration File Details All flags of a configuration file are described as follows: - - - - + + + + + @@ -173,7 +295,7 @@ cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf.xml + + + + + + + + + + + + + + + + + + @@ -225,7 +376,7 @@ cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf.xml @@ -236,7 +387,7 @@ cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf.xml Optional @@ -324,12 +475,13 @@ cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf.xml - + @@ -359,19 +511,38 @@ cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf.xml nodes. + + + + + + + + + + + +
List of configuration flags for Huawei Storage Driver
Flag name
- ControllerIP0 + Product Mandatory @@ -182,9 +304,29 @@ cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf.xml - IP address of a primary controller. + Type of a storage product. The value can be + T, Dorado, or + HVS.
ProtocolMandatory + + Type of a protocol. The value can be iSCSI or + FC. +
ControllerIP0Mandatory + + IP address of the primary controller (not required for the HVS)
ControllerIP1 @@ -196,9 +338,18 @@ cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf.xml - IP address of a secondary controller. + IP address of the secondary controller (not required for + the HVS)
HVSURLMandatory + + Access address of the Rest port (required only for the HVS)
UserName @@ -210,7 +361,7 @@ cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf.xml - Administrator user name. + User name of an administrator
- Administrator password. + Password of an administrator
- Thick + Thin Type of a created LUN. The value can be @@ -302,9 +453,9 @@ cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf.xml Cache prefetch strategy. The strategy can be constant - prefetch, variable prefetch, or intelligent prefetch. The - default value is 3, indicating - intelligent prefetch. + prefetch, variable prefetch, or intelligent prefetch. The default + value is 3, indicating intelligent prefetch. (not + required for the HVS)
- Name of a storage pool that you want to use. + Name of a storage pool that you want to use. (not required + for the Dorado2100 G2)
DefaultTargetIPMandatoryOptional
OSTypeOptional + Linux + The OS type of Nova computer node.
HostIPOptional + + The IPs of Nova computer nodes.
- Multiple initiators can be configured in one configuration file, - supporting multiple compute nodes. If a compute node initiator is not - configured, the compute node connects the default target. - Multiple storage pools can be configured in one configuration file, - supporting multiple storage pools in a storage system. - For more details, see command createlun in a - specific command-line interface (CLI) reference or run help -c - createlun in a storage system CLI. - After a 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. + 1. You can configure one iSCSI target port for each computing node or for all + computing nodes. The driver will check whether a target port IP address is + configured for the current computing node. If such an IP address is not + configured, select DefaultTargetIP. + 2. Multiple storage pools can be configured in one configuration file, + supporting the use of multiple storage pools in a storage system. (HVS allows + configuring only one StoragePool.) + 3. For details about LUN configuration information, see command + createlun in the specific command-line interface (CLI) + document for reference or run help -c createlun on the + storage system CLI. + 4. 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.