Huawei Driver¶
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.
Requirements¶
The OceanStor V3 series V300R002 storage system.
The following licenses should be activated on V3 for File:
CIFS
NFS
HyperSnap License (for snapshot)
Supported Operations¶
The following operations is supported on V3 storage:
Create CIFS/NFS Share
Delete CIFS/NFS Share
Allow CIFS/NFS Share access
IP and USER access types are supported for NFS(ro/rw).
Only USER access type is supported for CIFS(ro/rw).
Deny CIFS/NFS Share access
Create snapshot
Delete snapshot
Manage CIFS/NFS share
Support pools in one backend
Extend share
Shrink share
Support multi RestURLs(<RestURL>)
Support multi-tenancy
Ensure share
Create share from snapshot
Support QoS
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>
<SectorSize>64</SectorSize>
<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.
SectorSize is the size of the disk blocks, optional value can be “4”, “8”, “16”, “32” or “64”, and the units is KB. If “sectorsize” is configured in both share_type and xml file, the value of sectorsize in the share_type will be used. If “sectorsize” is configured in neither share_type nor xml file, huawei storage backends will provide a default value(64) when creating a new share.
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.
Restrictions¶
The Huawei driver has the following restrictions:
IP and USER access types are supported for NFS.
Only LDAP domain is supported for NFS.
Only USER access type is supported for CIFS.
Only AD domain is supported for CIFS.