openstack/deb-manila
Code Issues Proposed changes
5e333fc0f8
deb-manila/doc/source/devref/tegile_driver.rst
Abhilash Divakaran a8c5b41ab4 Add share driver for Tegile IntelliFlash Arrays 
The Tegile driver will support the NAS shares and it will
include the minimum set of features.
[Supported Protocols]
 - CIFS, NFS
The driver supports Manila driver mode
(driver_handles_share_servers = False).

Tegile has setup a CI. It will report as "Tegile Storage CI".

DocImpact
Implements: blueprint tegile-share-driver
Change-Id: I2e9154454e2a34f9a0653a173846ce554026f33b
2016-03-03 01:13:54 -08:00

7.1 KiB
Raw Blame History

Tegile Driver

The Tegile Manila driver uses Tegile IntelliFlash Arrays to provide shared filesystems to OpenStack.

The Tegile Driver interfaces with a Tegile Array via the REST API.

Requirements

  • Tegile IntelliFlash version 3.5.1
  • For using CIFS, Active Directory must be configured in the Tegile Array.

Supported Operations

The following operations are supported on a Tegile Array:

  • Create CIFS/NFS Share
  • Delete CIFS/NFS Share
  • Allow CIFS/NFS Share access
    • Only IP access type is supported for NFS
    • USER access type is supported for NFS and CIFS
    • RW and RO access supported
  • Deny CIFS/NFS Share access
    • IP access type is supported for NFS
    • USER access type is supported for NFS and CIFS
  • Create snapshot
  • Delete snapshot
  • Extend share
  • Shrink share
  • Create share from snapshot

Backend Configuration

The following parameters need to be configured in the [DEFAULT] section of /etc/manila/manila.conf:

[DEFAULT]

+============================+======================================================================================================+ | Option | Description | +----------------------------+-----------+------------------------------------------------------------------------------------------+ | enabled_share_backends | Name of the section on manila.conf used to specify a backend. | | | E.g. enabled_share_backends = tegileNAS | +----------------------------+------------------------------------------------------------------------------------------------------+ | enabled_share_protocols | Specify a list of protocols to be allowed for share creation. For Tegile driver this can be: | | | NFS or CIFS or NFS, CIFS. | +----------------------------+------------------------------------------------------------------------------------------------------+

The following parameters need to be configured in the [backend] section of /etc/manila/manila.conf:

[tegileNAS]

+===============================+=====================================================================================================+ | Option | Description | +-------------------------------+-----------------------------------------------------------------------------------------------------+ | share_backend_name | A name for the backend. | +-------------------------------+-----------------------------------------------------------------------------------------------------+ | share_driver | Python module path. For Tegile driver this must be: | | | manila.share.drivers.tegile.tegile.TegileShareDriver. | +-------------------------------+-----------------------------------------------------------------------------------------------------+ | driver_handles_share_servers| DHSS, Driver working mode. For Tegile driver this must be: | | | False. | +-------------------------------+-----------------------------------------------------------------------------------------------------+ | tegile_nas_server | Tegile array IP to connect from the Manila node. | +-------------------------------+-----------------------------------------------------------------------------------------------------+ | tegile_nas_login | This field is used to provide username credential to Tegile array. | +-------------------------------+-----------------------------------------------------------------------------------------------------+ | tegile_nas_password | This field is used to provide password credential to Tegile array. | +-------------------------------+-----------------------------------------------------------------------------------------------------+ | tegile_default_project | This field can be used to specify the default project in Tegile array where shares are created. | | | This field is optional. | +-------------------------------+-----------------------------------------------------------------------------------------------------+

Below is an example of a valid configuration of Tegile driver:

[DEFAULT]
enabled_share_backends = tegileNAS
enabled_share_protocols = NFS,CIFS
[tegileNAS]
driver_handles_share_servers = False
share_backend_name = tegileNAS
share_driver = manila.share.drivers.tegile.tegile.TegileShareDriver
tegile_nas_server = 10.12.14.16
tegile_nas_login = admin
tegile_nas_password = password
tegile_default_project = financeshares

Restart of manila-share service is needed for the configuration changes to take effect.

Restrictions

The Tegile driver has the following restrictions:

  • IP access type is supported only for NFS.
  • Only FLAT network is supported.

The manila.share.drivers.tegile.tegile Module

manila.share.drivers.tegile.tegile