diff --git a/doc/source/devref/netapp_cluster_mode_driver.rst b/doc/source/devref/netapp_cluster_mode_driver.rst index 88be3fb9eb..38615b3608 100644 --- a/doc/source/devref/netapp_cluster_mode_driver.rst +++ b/doc/source/devref/netapp_cluster_mode_driver.rst @@ -18,23 +18,67 @@ NetApp Clustered Data ONTAP =========================== The Manila Shared Filesystem Management Service can be configured to use -NetApp clustered Data ONTAP version 8. +NetApp Clustered Data ONTAP (cDOT) version 8.2 and 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 + +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 should exist, and -VLAN segmentation should be configured. - -The clustered Data ONTAP driver creates storage virtual machines (SVM, -previously known as vServers) as representations of Manila share server -interface, configures logical interfaces (LIFs) and stores shares there. +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); -- CIFS (authentication by user); +- NFS (access by IP address or subnet) +- CIFS (authentication by user) Required licenses ----------------- @@ -46,19 +90,19 @@ Required licenses Known restrictions ------------------ -- For CIFS shares an external active directory service is required. Its data - should be provided via security-service that is attached to used - share-network. -- Share access rule by user for CIFS shares can be created only for existing - user in active directory. -- To be able to configure clients to security services, the time on these - external security services and storage should be synchronized. The maximum - allowed clock skew is 5 minutes. +- 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.dataontap.cluster_mode.drv_multi_svm.py` Module -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +The :mod:`manila.share.drivers.netapp.common.py` Module +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: manila.share.drivers.netapp.dataontap.cluster_mode.drv_multi_svm +.. automodule:: manila.share.drivers.netapp.common :noindex: :members: :undoc-members: diff --git a/doc/source/devref/share_back_ends_feature_support_mapping.rst b/doc/source/devref/share_back_ends_feature_support_mapping.rst index 34250b6686..4d9ca30678 100644 --- a/doc/source/devref/share_back_ends_feature_support_mapping.rst +++ b/doc/source/devref/share_back_ends_feature_support_mapping.rst @@ -36,7 +36,7 @@ Mapping of share drivers and share features support +========================================+=============================+=======================+==============+==============+========================+============================+ | Generic (Cinder as back-end) | DHSS = True (J) & False (K) | K | L | L | J | J | +----------------------------------------+-----------------------------+-----------------------+--------------+--------------+------------------------+----------------------------+ -| NetApp Cluster Mode | ? | ? | ? | ? | ? | ? | +| NetApp Clustered Data ONTAP | DHSS = True (J) & False (K) | L | L | L | J | J | +----------------------------------------+-----------------------------+-----------------------+--------------+--------------+------------------------+----------------------------+ | EMC VNX | ? | ? | ? | ? | ? | ? | +----------------------------------------+-----------------------------+-----------------------+--------------+--------------+------------------------+----------------------------+ @@ -71,9 +71,9 @@ Mapping of share drivers and share access rules support + Driver name +--------------+------------+------------+--------------+------------+------------+ | | IP | USER | Cert | IP | USER | Cert | +========================================+==============+============+============+==============+============+============+ -| Generic (Cinder as back-end) | NFS,CIFS (J) | \- | \- | NFS (K) | \- | \- | +| Generic (Cinder as back-end) | NFS,CIFS (J) | \- | \- | NFS (K) | \- | \- | +----------------------------------------+--------------+------------+------------+--------------+------------+------------+ -| NetApp Cluster Mode | ? | ? | ? | ? | ? | ? | +| NetApp Clustered Data ONTAP | NFS,CIFS (J) | \- | \- | NFS (K) | \- | \- | +----------------------------------------+--------------+------------+------------+--------------+------------+------------+ | EMC VNX | ? | ? | ? | ? | ? | ? | +----------------------------------------+--------------+------------+------------+--------------+------------+------------+ @@ -104,7 +104,7 @@ Mapping of share drivers and security services support +========================================+==================+=================+==================+ | Generic (Cinder as back-end) | \- | \- | \- | +----------------------------------------+------------------+-----------------+------------------+ -| NetApp Cluster Mode | ? | ? | ? | +| NetApp Clustered Data ONTAP | J | J | J | +----------------------------------------+------------------+-----------------+------------------+ | EMC VNX | ? | ? | ? | +----------------------------------------+------------------+-----------------+------------------+