openstack/manila
Code Issues Proposed changes
c1f575ec05
manila/doc/source/admin/gpfs_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

3.5 KiB
Raw Blame History

GPFS Driver

GPFS driver uses IBM General Parallel File System (GPFS), a high-performance, clustered file system, developed by IBM, as the storage backend for serving file shares to the manila clients.

Supported shared filesystems

  • NFS (access by IP)

Supported Operations

  • Create NFS Share
  • Delete NFS Share
  • Create Share Snapshot
  • Delete Share Snapshot
  • Create Share from a Share Snapshot
  • Allow NFS Share access
    • Currently only 'rw' access level is supported
  • Deny NFS Share access

Requirements

  • Install GPFS with server license, version >= 2.0, on the storage backend.
  • Install Kernel NFS or Ganesha NFS server on the storage backend servers.
  • If using Ganesha NFS, currently NFS Ganesha v1.5 and v2.0 are supported.
  • Create a GPFS cluster and create a filesystem on the cluster, that will be used to create the manila shares.
  • Enable quotas for the GPFS file system (mmchfs -Q yes).
  • Establish network connection between the manila host and the storage backend.

Manila driver configuration setting

The following parameters in the manila configuration file need to be set:

  • share_driver = manila.share.drivers.ibm.gpfs.GPFSShareDriver
  • gpfs_share_export_ip = <IP to be added to GPFS export string>
  • If the backend GPFS server is not running on the manila host machine, the following options are required to SSH to the remote GPFS backend server:

    • gpfs_ssh_login = <GPFS server SSH login name>

      and one of the following settings is required to execute commands over SSH:

    • gpfs_ssh_private_key = <path to GPFS server SSH private key for login>

    • gpfs_ssh_password = <GPFS server SSH login password>

The following configuration parameters are optional:

  • gpfs_mount_point_base = <base folder where exported shares are located>
  • gpfs_nfs_server_type = <KNFS|GNFS>
  • gpfs_nfs_server_list = <list of the fully qualified NFS server names>
  • gpfs_ssh_port = <ssh port number>
  • knfs_export_options = <options to use when creating a share using kernel

    NFS server>

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

Known Restrictions

  • The driver does not support a segmented-network multi-tenancy model but instead works over a flat network where the tenants share a network.
  • While using remote GPFS node, with Ganesha NFS, 'gpfs_ssh_private_key' for remote login to the GPFS node must be specified and there must be a passwordless authentication already setup between the manila share service and the remote GPFS node.

The manila.share.drivers.ibm.gpfs Module

manila.share.drivers.ibm.gpfs