openstack/manila
Code Issues Proposed changes
c1f575ec05
manila/doc/source/admin/tegile_driver.rst
Tom Barron a149c283d7 doc: move stuff from contributor to admin 
As agreed in weekly manila community meetings and at the
Queens PTG, several documents currently presented to contributors
are really of general interest to cloud administrators and should
be presented accordingly.

Move the docs on manila back ends, the feature support mapping,
capabilities and extra specs, and export locations and metatdata
to the admin section.

Change-Id: I6d9dec56890fb3a9bc0539c45c43233517cea048
2017-10-18 15:55:24 -04: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