manila/doc/source/admin/infortrend_driver.rst
Kuirong.Chen 8c7c9e4012 [Infortrend] Add Infortrend Manila Doc
This patch updates the Manila administrator reference adding
documentation to the recently introduced Infortrend driver.

Closes-Bug: #1839486

Change-Id: I3332f90bc84fbc8918277d23ab7c51ede16376f2
2019-08-26 10:49:03 +08:00

3.1 KiB

Infortrend Driver for OpenStack Manila

The Infortrend Manila driver provides NFS and CIFS shared file systems to Openstack.

Requirements

  • The EonStor GS/GSe series Fireware version 139A23

Supported shared filesystems and operations

This driver supports NFS and CIFS shares.

The following operations are supported:

  • Create CIFS/NFS Share
  • Delete CIFS/NFS Share
  • Allow CIFS/NFS Share access
    • Only IP access type is supported for NFS (ro/rw).
    • Only USER access type is supported for CIFS (ro/rw).
  • Deny CIFS/NFS Share access
  • Manage a share.
  • Unmanage a share.
  • Extend a share.
  • Shrink a share.

Backend Configuration

The following parameters need to be configured in the manila configuration file for the Infortrend driver:

  • share_backend_name = <backend name to enable>
  • share_driver = manila.share.drivers.infortrend.driver.InfortrendNASDriver
  • driver_handles_share_servers = False
  • infortrend_nas_ip = <IP address for SSH access to the SAN controller>
  • infortrend_nas_user = <username with the 'edit' role>
  • infortrend_nas_password = <password for the user specified in infortrend_nas_user>
  • infortrend_share_pools = <Poolname of the SAN controller>
  • infortrend_share_channels = <Data channel for file service in SAN controller>

Share Types

When creating a share, a share type can be specified to determine where and how the share will be created. If a share type is not specified, the default_share_type set in the manila configuration file is used.

Manila requires that the share type includes the driver_handles_share_servers extra-spec. This ensures that the share will be created on a backend that supports the requested driver_handles_share_servers (share networks) capability. For the Infortrend driver, this must be set to False.

Back-end configuration example

[DEFAULT]
enabled_share_backends = ift-manila
enabled_share_protocols = NFS, CIFS

[ift-manila]
share_backend_name = ift-manila
share_driver = manila.share.drivers.infortrend.driver.InfortrendNASDriver
driver_handles_share_servers = False
infortrend_nas_ip = FAKE_IP
infortrend_nas_user = FAKE_USER
infortrend_nas_password = FAKE_PASS
infortrend_share_pools = pool-1, pool-2
infortrend_share_channels = 0, 1