# 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

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 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.

Description of Huawei share driver configuration options
Configuration option = Default value | Description
--- | ---
[DEFAULT] |
`manila_huawei_conf_file` = `/etc/manila/manila_huawei_conf.xml` | (String) The configuration file for the Manila Huawei driver.

this page last updated: 2026-03-20 00:30:00

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.

found an error? report a bug