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
|
||||
glusterfs_driver
|
||||
glusterfs_native_driver
|
||||
gpfs_driver
|
||||
huawei_nas_driver
|
||||
hdfs_native_driver
|
||||
|
||||
|
|
|
@ -15,17 +15,17 @@
|
|||
GPFS Driver for shares.
|
||||
|
||||
Config Requirements:
|
||||
GPFS file system must have quotas enabled (mmchfs -Q yes).
|
||||
GPFS file system must have quotas enabled (`mmchfs -Q yes`).
|
||||
Notes:
|
||||
GPFS independent fileset is used for each share.
|
||||
|
||||
TODO(nileshb): add support for share server creation/deletion/handling.
|
||||
|
||||
Limitation:
|
||||
1. 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 and the
|
||||
remote GPFS node.
|
||||
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.
|
||||
|
||||
"""
|
||||
import abc
|
||||
|
|
Loading…
Reference in New Issue