Huawei NAS Driver is a plugin based the OpenStack manila service. The Huawei NAS
Driver can be used to provide functions such as the share and snapshot for virtual
machines(instances) in OpenStack. Huawei NAS Driver enables the OceanStor V3 series
V300R002 storage system to provide only network filesystems for OpenStack.
Pre-Configurations on Huawei
1. Create a driver configuration file. The driver configuration file name must
be the same as the manila_huawei_conf_file item in the manila_conf configuration
file.
2. Configure Product.
Product indicates the storage system type. For the OceanStor V3 series V300R002
storage systems, the driver configuration file is as follows:
<?xml version='1.0' encoding='UTF-8'?>
<Config>
<Storage>
<Product>V3</Product>
<LogicalPortIP>x.x.x.x</LogicalPortIP>
<Port>abc;CTE0.A.H1</Port>
<RestURL>https://x.x.x.x:8088/deviceManager/rest/;
https://x.x.x.x:8088/deviceManager/rest/</RestURL>
<UserName>xxxxxxxxx</UserName>
<UserPassword>xxxxxxxxx</UserPassword>
</Storage>
<Filesystem>
<StoragePool>xxxxxxxxx</StoragePool>
<AllocType>xxxxxxxx</AllocType>
<WaitInterval>3</WaitInterval>
<Timeout>60</Timeout>
<NFSClient>
<IP>x.x.x.x</IP>
</NFSClient>
<CIFSClient>
<UserName>xxxxxxxxx</UserName>
<UserPassword>xxxxxxxxx</UserPassword>
</CIFSClient>
</Filesystem>
</Config>
- Product is a type of a storage product. Set it to V3.
- LogicalPortIP is an IP address of the logical port.
- Port is a port name list of bond port or ETH port, used to
create vlan and logical port. Multi Ports can be configured in
<Port>(separated by ”;”). If <Port> is not configured, then will choose
an online port on the array.
- RestURL is an access address of the REST interface. Multi RestURLs
can be configured in <RestURL>(separated by ”;”). When one of the RestURL
failed to connect, driver will retry another automatically.
- UserName is a user name of an administrator.
- UserPassword is a password of an administrator.
- StoragePool is a name of a storage pool to be used.
- AllocType is the file system space allocation type, optional value is “Thick” or “Thin”.
- WaitInterval is the interval time of querying the file system status.
- Timeout is the timeout period for waiting command execution of a device to
complete.
- NFSClientIP is the backend IP in admin network to use for mounting NFS share.
- CIFSClientUserName is the backend user name in admin network to use for mounting CIFS share.
- CIFSClientUserPassword is the backend password in admin network to use for mounting CIFS share.
Backend Configuration
Modify the manila.conf manila configuration file and add share_driver and
manila_huawei_conf_file items.
Example for configuring a storage system:
- share_driver = manila.share.drivers.huawei.huawei_nas.HuaweiNasDriver
- manila_huawei_conf_file = /etc/manila/manila_huawei_conf.xml
- driver_handles_share_servers = True or False
Note
- If driver_handles_share_servers is True, the driver will choose a port
in <Port> to create vlan and logical port for each tenant network.
And the share type with the DHSS extra spec should be set to True when
creating shares.
- If driver_handles_share_servers is False, then will use the IP in
<LogicalPortIP>. Also the share type with the DHSS extra spec should be
set to False when creating shares.
Restart of manila-share service is needed for the configuration changes to take
effect.
Share Types
When creating a share, a share type can be specified to determine where and
how the share will be created. If a share type is not specified, the
default_share_type set in the manila configuration file is used.
Manila requires that the share type includes the driver_handles_share_servers
extra-spec. This ensures that the share will be created on a backend that
supports the requested driver_handles_share_servers (share networks) capability.
For the Huawei driver, this must be set to False.
Another common manila extra-spec used to determine where a share is created
is share_backend_name. When this extra-spec is defined in the share type,
the share will be created on a backend with a matching share_backend_name.
Manila “share types” may contain qualified extra-specs, -extra-specs that
have significance for the backend driver and the CapabilityFilter. This
commit makes the Huawei driver report the following boolean capabilities:
- capabilities:dedupe
- capabilities:compression
- capabilities:thin_provisioning
- capabilities:huawei_smartcache
- huawei_smartcache:cachename
- capabilities:huawei_smartpartition
- huawei_smartpartition:partitionname
- capabilities:qos
- qos:maxIOPS
- qos:minIOPS
- qos:minbandwidth
- qos:maxbandwidth
- qos:latency
- qos:iotype
The scheduler will choose a host that supports the needed
capability when the CapabilityFilter is used and a share
type uses one or more of the following extra-specs:
- capabilities:dedupe=’<is> True’ or ‘<is> False’
- capabilities:compression=’<is> True’ or ‘<is> False’
- capabilities:thin_provisioning=’<is> True’ or ‘<is> False’
- capabilities:huawei_smartcache=’<is> True’ or ‘<is> False’
- huawei_smartcache:cachename=test_cache_name
- capabilities:huawei_smartpartition=’<is> True’ or ‘<is> False’
- huawei_smartpartition:partitionname=test_partition_name
- capabilities:qos=’<is> True’ or ‘<is> False’
- qos:maxIOPS=100
- qos:minIOPS=10
- qos:maxbandwidth=100
- qos:minbandwidth=10
- qos:latency=10
- qos:iotype=0
thin_provisioning will be reported as [True, False] for Huawei backends.
dedupe will be reported as [True, False] for Huawei backends.
compression will be reported as [True, False] for Huawei backends.
huawei_smartcache will be reported as [True, False] for Huawei backends.
Adds SSDs into a high-speed cache pool and divides the pool into
multiple cache partitions to cache hotspot data in random and small read I/Os.
huawei_smartpartition will be reported as [True, False] for Huawei backends.
Add share to the smartpartition named ‘test_partition_name’.
Allocates cache resources based on service characteristics,
ensuring the quality of critical services.
qos will be reported as True for backends that use QoS (Quality of Service)
specification.