Tom Barron fae499cb73 doc migration: configuration reference

In accord with the OpenStack documentation migration spec [1],
this patch pulls over material from the centralized Configuration
Reference so that it will not be lost.  As indicated in the spec,
dynamic generation of this material will be left for later work.

[1] https://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html

Closes-Bug: #1706181
Depends-On: Ib0fca0c16e14c05307bfc31ae50c65271b7402f1
Depends-On: Ia750cb049c0f53a234ea70ce1f2bbbb7a2aa9454

Change-Id: I7f3b584ac9907da1f07dedd26324cf4703bc7e6c

2017-08-25 13:21:08 +00:00

3.6 KiB

Raw Blame History

Huawei driver

Huawei NAS driver is a plug-in based on the Shared File Systems service. The Huawei NAS driver can be used to provide functions such as the share and snapshot for virtual machines, or 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 shared filesystems and operations

The driver supports CIFS and NFS shares.

The following operations are supported:

Create a share.
Delete a share.
Allow share access.

Note the following limitations:
- Only IP access type is supported for NFS.
- Only user access is supported for CIFS.
Deny share access.
Create a snapshot.
Delete a snapshot.
Support pools in one backend.
Extend a share.
Shrink a share.
Create a replica.
Delete a replica.
Promote a replica.
Update a replica state.

Pre-configurations on Huawei

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.
Configure the 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>
        <RestURL>https://x.x.x.x:8088/deviceManager/rest/</RestURL>
        <UserName>xxxxxxxxx</UserName>
        <UserPassword>xxxxxxxxx</UserPassword>
    </Storage>
    <Filesystem>
        <Thin_StoragePool>xxxxxxxxx</Thin_StoragePool>
        <Thick_StoragePool>xxxxxxxxx</Thick_StoragePool>
        <WaitInterval>3</WaitInterval>
        <Timeout>60</Timeout>
    </Filesystem>
</Config>
```
The options are:
- Product is a type of storage product. Set it to V3.
- LogicalPortIP is the IP address of the logical port.
- RestURL is an access address of the REST interface. Multiple RestURLs can be configured in <RestURL>, separated by ";". The driver will automatically retry another RestURL if one fails to connect.
- UserName is the user name of an administrator.
- UserPassword is the password of an administrator.
- Thin_StoragePool is the name of a thin storage pool to be used.
- Thick_StoragePool is the name of a thick storage pool to be used.
- 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.

Back end configuration

Modify the manila.conf Shared File Systems service configuration file and add share_driver and manila_huawei_conf_file items. Here is an 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 = False

Driver options

The following table contains the configuration options specific to the share driver.

3.6 KiB Raw Blame History