9f3c566a10
The NetApp driver has been working with FlexVol ONTAP volumes. The driver does not support scaling FlexVol volumes higher than 100 TiB, which was a theoretical limit for the large namespace that these containers were meant to handle. ONTAP's Flexgroup volumes eliminate such limitations. So, added the support for provisioning share as FlexGroup in the NetApp driver. The FlexGroup provision is enabled by new option `netapp_enable_flexgroup`, which will make the driver report a single pool represeting all aggregates. The selection on which aggregates the FlexGroup share will reside is up to ONTAP. If the administrator desires to control that selection through Manila scheduler, it must inform the set of aggregates that formss FlexGroup pool in the new option `netapp_flexgroup_pool`. Each NetApp pool will report now the capability: `netapp_flexgroup` informing which type the pool is. The following operations are allowed with FlexGroup shares (DHSS True/False and NFS/CIFS): - Create/Delete share; - Shrink/Extend share; - Create/Delete snapshot; - Revert to snapshot; - Manage/Unmanage snapshots; - Create from snapshot; - Replication[1] - Manage/Unmanage shares; The backend with one FlexGroup pool configured will drop the consistent snapshot support for all pools. The driver FlexGroup support requires ONTAP version 9.8 or greater. [1] FlexGroup is limited to one single replica for ONTAP version lower than 9.9.1. DocImpact Depends-On: If525e97a5d456d6ddebb4bf9bc8ff6190c95a555 Depends-On: I646f782c3e2be5ac799254f08a248a22cb9e0358 Implements: bp netapp-flexgroup-support Change-Id: I4f68a9bb33be85f9a22e0be4ccf673647e713459 Signed-off-by: Felipe Rodrigues <felipefuty01@gmail.com>
140 lines
4.3 KiB
ReStructuredText
140 lines
4.3 KiB
ReStructuredText
..
|
|
Copyright 2014 Mirantis Inc.
|
|
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.
|
|
|
|
NetApp Clustered Data ONTAP
|
|
===========================
|
|
|
|
The Shared File Systems service can be configured to use
|
|
NetApp Clustered Data ONTAP (cDOT) version 8.2 and later.
|
|
|
|
The driver can work with two types of pools: FlexGroup and FlexVol. By default,
|
|
it only works with FlexVol, if desired, the FlexGroup pool can be enabled
|
|
together or standalone.
|
|
|
|
FlexGroup pool requires ONTAP version 9.8 or later.
|
|
|
|
Supported Operations
|
|
--------------------
|
|
|
|
The following operations are supported on Clustered Data ONTAP:
|
|
|
|
- Create CIFS/NFS Share
|
|
- Delete CIFS/NFS Share
|
|
- Allow NFS Share access
|
|
|
|
* IP access type is supported for NFS.
|
|
* Read/write and read-only access are supported for NFS.
|
|
|
|
- Allow CIFS Share access
|
|
|
|
* User access type is supported for CIFS.
|
|
* Read/write access is supported for CIFS.
|
|
|
|
- Deny CIFS/NFS Share access
|
|
- Create snapshot
|
|
- Delete snapshot
|
|
- Create share from snapshot
|
|
- Extend share
|
|
- Shrink share
|
|
- Manage share
|
|
- Unmanage share
|
|
- Create consistency group
|
|
- Delete consistency group
|
|
- Create consistency group from CG snapshot
|
|
- Create CG snapshot
|
|
- Delete CG snapshot
|
|
- Create a replica (DHSS=False)
|
|
- Promote a replica (DHSS=False)
|
|
- Delete a replica (DHSS=False)
|
|
- Update a replica (DHSS=False)
|
|
- Create a replicated snapshot (DHSS=False)
|
|
- Delete a replicated snapshot (DHSS=False)
|
|
- Update a replicated snapshot (DHSS=False)
|
|
- Migrate share
|
|
- Migrate share server
|
|
|
|
.. note::
|
|
|
|
The operations are not fully supported configuring FlexGroup pool:
|
|
|
|
- Consistency group operations are only supported configuring the driver
|
|
without any FlexGroup pool.
|
|
- For FlexGroup share, create more than one replica is only allowed with
|
|
ONTAP 9.9.1 and newer.
|
|
- Migration of FlexGroup shares is not allowed.
|
|
- Migration of share servers containing FlexGroup share is not allowed.
|
|
|
|
.. note::
|
|
|
|
:term:`DHSS` is abbreviated from `driver_handles_share_servers`.
|
|
|
|
Supported Operating Modes
|
|
-------------------------
|
|
|
|
The cDOT driver supports both 'driver_handles_share_servers' (:term:`DHSS`)
|
|
modes.
|
|
|
|
If 'driver_handles_share_servers' is True, the driver will create a storage
|
|
virtual machine (SVM, previously known as vServers) for each unique tenant
|
|
network and provision each of a tenant's shares into that SVM. This requires
|
|
the user to specify both a share network as well as a share type with the DHSS
|
|
extra spec set to True when creating shares.
|
|
|
|
If 'driver_handles_share_servers' is False, the manila admin must configure a
|
|
single SVM, along with associated LIFs and protocol services, that will be
|
|
used for provisioning shares. The SVM is specified in the manila config file.
|
|
|
|
Network approach
|
|
----------------
|
|
|
|
L3 connectivity between the storage cluster and manila host must exist, and
|
|
VLAN segmentation may be configured. All of manila's network plug-ins are
|
|
supported with the cDOT driver.
|
|
|
|
Supported shared filesystems
|
|
----------------------------
|
|
|
|
- NFS (access by IP address or subnet)
|
|
- CIFS (authentication by user)
|
|
|
|
Required licenses
|
|
-----------------
|
|
|
|
- NFS
|
|
- CIFS
|
|
- FlexClone
|
|
|
|
Known restrictions
|
|
------------------
|
|
|
|
- For CIFS shares an external Active Directory (AD) service is required. The AD
|
|
details should be provided via a manila security service that is attached to
|
|
the specified share network.
|
|
- Share access rules for CIFS shares may be created only for existing users
|
|
in Active Directory.
|
|
- The time on external security services and storage must be synchronized. The
|
|
maximum allowed clock skew is 5 minutes.
|
|
- cDOT supports only flat and VLAN network segmentation types.
|
|
|
|
The :mod:`manila.share.drivers.netapp.common.py` Module
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. automodule:: manila.share.drivers.netapp.common
|
|
:noindex:
|
|
:members:
|
|
:undoc-members:
|
|
:show-inheritance:
|