Update feature support mapping doc for NetApp cDOT

Update the new .rst document that lists per-driver feature support
with details for the NetApp cDOT driver, and update the cDOT-specific
driver document to cover features added in Liberty.

Change-Id: I53cf0ac1f2492cfba599276c5dc049b3ae19f4c3

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
+L3 connectivity between the storage cluster and Manila host must exist, and
-VLAN segmentation should be configured.
+VLAN segmentation may be configured.  All of Manila's network plug-ins are
-
+supported with the cDOT driver.
-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.
 
 Supported shared filesystems
 ----------------------------
 
-- NFS (access by IP);
+- NFS (access by IP address or subnet)
-- CIFS (authentication by user);
+- 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
+- For CIFS shares an external Active Directory (AD) service is required. The AD
-  should be provided via security-service that is attached to used
+  details should be provided via a Manila security service that is attached to
-  share-network.
+  the specified share network.
-- Share access rule by user for CIFS shares can be created only for existing
+- Share access rules for CIFS shares may be created only for existing users
-  user in active directory.
+  in Active Directory.
-- To be able to configure clients to security services, the time on these
+- The time on external security services and storage must be synchronized. The
-  external security services and storage should be synchronized. The maximum
+  maximum allowed clock skew is 5 minutes.
-  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:

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                |         ?        |         ?       |         ?        |
 +----------------------------------------+------------------+-----------------+------------------+