IBM GPFS Manila Driver Docs
Adding documentation for the IBM GPFS Manila driver. Implements: blueprint gpfs-driver Change-Id: Idc098ca1005c59e80df212285e5bfb523e36376b
This commit is contained in:
parent
7b00db5f37
commit
5ccfe81eea
|
@ -0,0 +1,102 @@
|
||||||
|
..
|
||||||
|
Copyright 2015 IBM Corp.
|
||||||
|
All Rights Reserved.
|
||||||
|
|
||||||
|
Licensed under the Apache License, Version 2.0 (the "License"); you may
|
||||||
|
not use this file except in compliance with the License. You may obtain
|
||||||
|
a copy of the License at
|
||||||
|
|
||||||
|
http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
|
||||||
|
Unless required by applicable law or agreed to in writing, software
|
||||||
|
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
||||||
|
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
||||||
|
License for the specific language governing permissions and limitations
|
||||||
|
under the License.
|
||||||
|
|
||||||
|
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.
|
||||||
|
- 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.
|
||||||
|
- Currently, NFS Ganesha v1.5 and v2.0 are supported.
|
||||||
|
- 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 :mod:`manila.share.drivers.ibm.gpfs` Module
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. automodule:: manila.share.drivers.ibm.gpfs
|
||||||
|
:noindex:
|
||||||
|
:members:
|
||||||
|
:undoc-members:
|
||||||
|
:show-inheritance:
|
|
@ -84,6 +84,7 @@ Share backends
|
||||||
generic_driver
|
generic_driver
|
||||||
glusterfs_driver
|
glusterfs_driver
|
||||||
glusterfs_native_driver
|
glusterfs_native_driver
|
||||||
|
gpfs_driver
|
||||||
huawei_nas_driver
|
huawei_nas_driver
|
||||||
hdfs_native_driver
|
hdfs_native_driver
|
||||||
|
|
||||||
|
|
|
@ -15,17 +15,17 @@
|
||||||
GPFS Driver for shares.
|
GPFS Driver for shares.
|
||||||
|
|
||||||
Config Requirements:
|
Config Requirements:
|
||||||
GPFS file system must have quotas enabled (mmchfs -Q yes).
|
GPFS file system must have quotas enabled (`mmchfs -Q yes`).
|
||||||
Notes:
|
Notes:
|
||||||
GPFS independent fileset is used for each share.
|
GPFS independent fileset is used for each share.
|
||||||
|
|
||||||
TODO(nileshb): add support for share server creation/deletion/handling.
|
TODO(nileshb): add support for share server creation/deletion/handling.
|
||||||
|
|
||||||
Limitation:
|
Limitation:
|
||||||
1. While using remote GPFS node, with Ganesha NFS, 'gpfs_ssh_private_key'
|
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
|
for remote login to the GPFS node must be specified and there must be
|
||||||
a passwordless authentication already setup between the Manila and the
|
a passwordless authentication already setup between the Manila share
|
||||||
remote GPFS node.
|
service and the remote GPFS node.
|
||||||
|
|
||||||
"""
|
"""
|
||||||
import abc
|
import abc
|
||||||
|
|
Loading…
Reference in New Issue