90060722a9
This patch introduces a new directory layout in doc/source in conformance with the OpenStack manuals project migration spec [1], moves the existing content in manila/doc/source into the new directories, and adjusts index files accordingly. This is the first step in the migration process as outlined in the spec. [1] https://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html Partial-Bug: #1706181 Needed-By: I7924d94b82e7c8d9716bad7a219fc38c57970773 Depends-On: Ifc80fc56648cef74c85464321d1850e8c68449a0 Depends-On: Ia750cb049c0f53a234ea70ce1f2bbbb7a2aa9454 Change-Id: Ieea33262101a1d2459492c1c8aaac5fe042279f6
90 lines
3.1 KiB
ReStructuredText
90 lines
3.1 KiB
ReStructuredText
..
|
|
Copyright 2015 Intel, 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.
|
|
|
|
HDFS native driver
|
|
==================
|
|
|
|
HDFS native driver is a plugin based on the OpenStack manila service, which uses
|
|
Hadoop distributed file system (HDFS), a distributed file system designed to hold
|
|
very large amounts of data, and provide high-throughput access to the data.
|
|
|
|
A manila share in this driver is a subdirectory in hdfs root directory. Instances
|
|
talk directly to the HDFS storage backend with 'hdfs' protocol. And access to each
|
|
share is allowed by user based access type, which is aligned with HDFS ACLs to
|
|
support access control of multiple users and groups.
|
|
|
|
Network configuration
|
|
---------------------
|
|
|
|
The storage backend and manila hosts should be in a flat network, otherwise, the L3
|
|
connectivity between them should exist.
|
|
|
|
Supported shared filesystems
|
|
----------------------------
|
|
|
|
- HDFS (authentication by user)
|
|
|
|
Supported Operations
|
|
--------------------
|
|
|
|
- Create HDFS share
|
|
- Delete HDFS share
|
|
- Allow HDFS Share access
|
|
* Only support user access type
|
|
* Support level of access (ro/rw)
|
|
- Deny HDFS Share access
|
|
- Create snapshot
|
|
- Delete snapshot
|
|
- Create share from snapshot
|
|
- Extend share
|
|
|
|
Requirements
|
|
------------
|
|
|
|
- Install HDFS package, version >= 2.4.x, on the storage backend
|
|
- To enable access control, the HDFS file system must have ACLs enabled
|
|
- Establish network connection between the manila host and storage backend
|
|
|
|
Manila driver configuration
|
|
---------------------------
|
|
|
|
- `share_driver` = manila.share.drivers.hdfs.hdfs_native.HDFSNativeShareDriver
|
|
- `hdfs_namenode_ip` = the IP address of the HDFS namenode, and only single
|
|
namenode is supported now
|
|
- `hdfs_namenode_port` = the port of the HDFS namenode service
|
|
- `hdfs_ssh_port` = HDFS namenode SSH port
|
|
- `hdfs_ssh_name` = HDFS namenode SSH login name
|
|
- `hdfs_ssh_pw` = HDFS namenode SSH login password, this parameter is not
|
|
necessary, if the following `hdfs_ssh_private_key` is configured
|
|
- `hdfs_ssh_private_key` = Path to the HDFS namenode private key to ssh login
|
|
|
|
Known Restrictions
|
|
------------------
|
|
|
|
- This driver does not support network segmented multi-tenancy model. Instead
|
|
multi-tenancy is supported by the tenant specific user authentication
|
|
- Only support for single HDFS namenode in Kilo release
|
|
|
|
The :mod:`manila.share.drivers.hdfs.hdfs_native` Module
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. automodule:: manila.share.drivers.hdfs.hdfs_native
|
|
:noindex:
|
|
:members:
|
|
:undoc-members:
|
|
:show-inheritance:
|
|
|