c41dbfc0e2
Shared File Systems service (manila) should be added to the Config Ref similar to Block Storage (cinder). The content would be similar to cinder in that it would have sections to describe Intro, Drivers, Log Files and Options. Change-Id: I89fc64f8cd4fe880b36017139e7989f3a4100cc6 Implements: blueprint manila-config-ref
138 lines
3.8 KiB
XML
138 lines
3.8 KiB
XML
<section xml:id="isilon-driver" xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
|
|
<title>EMC Isilon driver</title>
|
|
<para>
|
|
The EMC Shared File Systems driver framework (EMCShareDriver)
|
|
utilizes EMC
|
|
storage products to provide shared file systems to OpenStack. The EMC
|
|
driver is a plug-in based driver which is designed to use
|
|
different plug-ins to manage different EMC storage products.
|
|
</para>
|
|
<para>
|
|
The Isilon driver is a plug-in for the EMC framework which allows
|
|
the Shared File Systems service to interface with an Isilon back end to
|
|
provide a shared filesystem. The EMC driver framework with the
|
|
Isilon plug-in is referred to as the "Isilon Driver" in
|
|
this document.
|
|
</para>
|
|
<para>
|
|
This Isilon Driver interfaces with an Isilon cluster via the REST
|
|
Isilon Platform API (PAPI) and the RESTful Access to Namespace API
|
|
(RAN).
|
|
</para>
|
|
<simplesect>
|
|
<title>Requirements</title>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
Isilon cluster running OneFS 7.2 or higher
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</simplesect>
|
|
<simplesect>
|
|
<title>Supported operations</title>
|
|
<para>
|
|
The following operations will be supported on an Isilon cluster:
|
|
</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
Create CIFS/NFS share.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Delete CIFS/NFS share.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Allow CIFS/NFS share access.
|
|
</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
Only IP access type is supported for NFS and CIFS.
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>
|
|
* Only RW access is supported.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Deny CIFS/NFS share access
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Create snapshot
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Delete snapshot
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Create share from snapshot
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</simplesect>
|
|
<simplesect>
|
|
<title>Backend configuration</title>
|
|
<para>
|
|
The following parameters need to be configured in the Shared
|
|
File Systems service configuration file for the Isilon driver:
|
|
</para>
|
|
<blockquote>
|
|
<para>
|
|
share_driver = manila.share.drivers.emc.driver.EMCShareDriver
|
|
emc_share_backend = isilon emc_nas_server = <IP address of
|
|
Isilon cluster> emc_nas_login = <username>
|
|
emc_nas_password = <password> isilon_share_root_dir =
|
|
<directory on Isilon where shares will be created>
|
|
</para>
|
|
</blockquote>
|
|
<para>
|
|
Restart of manila-share service is needed for the configuration
|
|
changes to take effect.
|
|
</para>
|
|
</simplesect>
|
|
<simplesect>
|
|
<title>Restrictions</title>
|
|
<para>
|
|
The Isilon driver has the following restrictions:
|
|
</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
Only IP access type is supported for NFS and CIFS.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Only FLAT network is supported.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Quotas are not yet supported.
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</simplesect>
|
|
<simplesect>
|
|
<title>Driver configuration options</title>
|
|
<para>
|
|
Configuration options specific to this driver are documented here:
|
|
<xref linkend="config_table_manila_emc"/>.
|
|
</para>
|
|
</simplesect>
|
|
</section>
|