taikun.cloud

Taikun OCP Guide

Table of Contents

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>

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