manila/ibm-spectrumscale-driver.rst at 5f7812e00a797a510e4370d7d4d0567ac280405d

junboli aa9b9df84c Fix incorrect literal_block error when build docs

This causes failure when use build_sphinx to generate docs.
Fix it by replace the ini code block  with console.

Change-Id: Iaf15fc99fefceb58c765fabc947f99ad8225723b
Closes-bug: #1713291

2017-08-28 09:51:40 +08:00

5.3 KiB

Raw Blame History

IBM Spectrum Scale is a flexible software-defined storage product that can be deployed as high-performance file storage or a cost optimized large-scale content repository. IBM Spectrum Scale, previously known as IBM General Parallel File System (GPFS), is designed to scale performance and capacity with no bottlenecks. IBM Spectrum Scale is a cluster file system that provides concurrent access to file systems from multiple nodes. The storage provided by these nodes can be direct attached, network attached, SAN attached, or a combination of these methods. Spectrum Scale provides many features beyond common data access, including data replication, policy based storage management, and space efficient file snapshot and clone operations.

Supported shared filesystems and operations (NFS shares only)

The Spectrum Scale share driver supports NFS shares.

The following operations are supported:

Create a share.
Delete a share.
Allow share access.
- Only IP access type is supported.
- Both RW & RO access level is supported.
Deny share access.
Create a share snapshot.
Delete a share snapshot.
Create a share from a snapshot.
Extend a share.
Manage a share.
Unmanage a share.

Requirements

Spectrum Scale must be installed and a cluster must be created that includes one or more storage nodes and protocol server nodes. The NFS server running on these nodes is used to export shares to storage consumers in OpenStack virtual machines or even to bare metal storage consumers in the OpenStack environment. A file system must also be created and mounted on these nodes before configuring the manila service to use Spectrum Scale storage. For more details, refer to Spectrum Scale product documentation.

Spectrum Scale supports two ways of exporting data through NFS with high availability.

CES (which uses Ganesha NFS)
- This is provided inherently by the protocol support in Spectrum Scale and is a recommended method for NFS access.
CNFS (which uses kernel NFS)

For more information on NFS support in Spectrum Scale, refer to Protocol support in Spectrum Scale and NFS Support overview in Spectrum Scale.

The following figure is an example of Spectrum Scale architecture with OpenStack services:

Quotas should be enabled for the Spectrum Scale filesystem to be exported through NFS using Spectrum Scale share driver. Use the following command to enable quota for a filesystem:

$ mmchfs <filesystem> -Q yes

Limitation

Spectrum Scale share driver currently supports creation of NFS shares in the flat network space only. For example, the Spectrum Scale storage node exporting the data should be in the same network as that of the Compute VMs which mount the shares acting as NFS clients.

Driver configuration

Spectrum Scale share driver supports creation of shares using both NFS servers (Ganesha using Spectrum Scale CES/Kernel NFS).

For both the NFS server types, you need to set the share_driver in the manila.conf as:

share_driver = manila.share.drivers.ibm.gpfs.GPFSShareDriver

Spectrum Scale CES (NFS Ganesha server)

To use Spectrum Scale share driver in this mode, set the gpfs_share_helpers in the manila.conf as:

gpfs_share_helpers = CES=manila.share.drivers.ibm.gpfs.CESHelper

Following table lists the additional configuration options which are used with this driver configuration.

Note

Configuration options related to ssh are required only if is_gpfs_node is set to False.

Spectrum Scale Clustered NFS (Kernel NFS server)