openstack/manila
Code Issues Proposed changes
25d3306f9f
manila/doc/source/admin/netapp_cluster_mode_driver.rst
Felipe Rodrigues 9f3c566a10 [NetApp] Add FlexGroup volume support 
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>
2021-09-08 15:47:15 -03:00

4.3 KiB
Raw Blame History

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

DHSS is abbreviated from driver_handles_share_servers.

Supported Operating Modes

The cDOT driver supports both 'driver_handles_share_servers' (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 manila.share.drivers.netapp.common.py Module

manila.share.drivers.netapp.common