From 761198f53644887df3e871b373c7885c8c360c3e Mon Sep 17 00:00:00 2001 From: Bob Callaway Date: Thu, 2 Oct 2014 14:59:00 -0400 Subject: [PATCH] Deprecate / obsolete NetApp volume extra specs The NetApp Data ONTAP (Cluster-mode) NFS & iSCSI drivers for Juno support the Cinder pools feature, but the drivers are reporting two qualified extra specs that must be converted to unqualified extra specs in order to be used by the Cinder scheduler's capability filter. Furthermore, there are four extra specs that must be deprecated due to having the pools feature. This patch updates the documentation to update the extra specs and formally denote the deprecation. Change-Id: I36ab7ed86bdad09ff25c6f2cc280212ca8d52b98 --- .../tables/cinder-netapp_cdot_extraspecs.xml | 29 +++++++++---------- .../drivers/netapp-volume-driver.xml | 11 ------- 2 files changed, 13 insertions(+), 27 deletions(-) diff --git a/doc/common/tables/cinder-netapp_cdot_extraspecs.xml b/doc/common/tables/cinder-netapp_cdot_extraspecs.xml index 16957df397..40fc43d341 100644 --- a/doc/common/tables/cinder-netapp_cdot_extraspecs.xml +++ b/doc/common/tables/cinder-netapp_cdot_extraspecs.xml @@ -15,60 +15,57 @@ - netapp:raid_type + netapp_raid_type String Limit the candidate volume list based on one of the following raid types: raid4, raid_dp. - netapp:disk_type + netapp_disk_type String - Limit the candidate volume list based on one of the following disk types: ATA, BSAS, EATA, FCAL, FSAS, LUN, MSATA, - SAS, SATA, SCSI, XATA, XSAS, or SSD. + Limit the candidate volume list based on one of the following disk types: ATA, BSAS, EATA, FCAL, FSAS, LUN, MSATA, SAS, SATA, SCSI, XATA, XSAS, or SSD. - netapp:qos_policy_group + netapp:qos_policy_groupPlease note that this extra spec has a colon (:) in its name because it is used by the driver to assign the QoS policy group to the OpenStack Block Storage volume after it has been provisioned. String - Specify the name of a QoS policy group, which defines measurable Service Level Objectives, that should be applied to the OpenStack Block Storage volume - at the time of volume creation. Ensure that the QoS policy group object within Data ONTAP should be defined before an OpenStack Block Storage volume - is created, and that the QoS policy group is not associated with the destination FlexVol volume. + Specify the name of a QoS policy group, which defines measurable Service Level Objectives, that should be applied to the OpenStack Block Storage volume at the time of volume creation. Ensure that the QoS policy group object within Data ONTAP should be defined before an OpenStack Block Storage volume is created, and that the QoS policy group is not associated with the destination FlexVol volume. - netapp_mirroredIf both the positive and negative specs for a pair are specified (for example, netapp_dedup and netapp_nodedup) and set to the same value within a single extra_specs list, then neither spec will be utilized by the driver. + netapp_mirrored Boolean Limit the candidate volume list to only the ones that are mirrored on the storage controller. - netapp_unmirrored + netapp_unmirroredIn the Juno release, these negative-assertion extra specs are formally deprecated by the NetApp unified driver. Instead of using the deprecated negative-assertion extra specs (for example, ) with a value of true, use the corresponding positive-assertion extra spec (for example, ) with a value of false. Boolean Limit the candidate volume list to only the ones that are not mirrored on the storage controller. - netapp_dedup + netapp_dedup Boolean Limit the candidate volume list to only the ones that have deduplication enabled on the storage controller. - netapp_nodedup + netapp_nodedup Boolean Limit the candidate volume list to only the ones that have deduplication disabled on the storage controller. - netapp_compression + netapp_compression Boolean Limit the candidate volume list to only the ones that have compression enabled on the storage controller. - netapp_nocompression + netapp_nocompression Boolean Limit the candidate volume list to only the ones that have compression disabled on the storage controller. - netapp_thin_provisioned + netapp_thin_provisioned Boolean Limit the candidate volume list to only the ones that support thin provisioning on the storage controller. - netapp_thick_provisioned + netapp_thick_provisioned Boolean Limit the candidate volume list to only the ones that support thick provisioning on the storage controller. diff --git a/doc/config-reference/block-storage/drivers/netapp-volume-driver.xml b/doc/config-reference/block-storage/drivers/netapp-volume-driver.xml index b252f5aedb..2c67c8d9c3 100644 --- a/doc/config-reference/block-storage/drivers/netapp-volume-driver.xml +++ b/doc/config-reference/block-storage/drivers/netapp-volume-driver.xml @@ -281,17 +281,6 @@ nfs_shares_config = /etc/cinder/nfs_sharescinder type-key command. - - It is recommended to only set the value of extra - specs to True when combining - multiple specs to enforce a certain logic set. If - you desire to remove volumes with a certain - feature enabled from consideration from the OpenStack Block Storage - volume scheduler, be sure to use the negated spec - name with a value of True - rather than setting the positive spec to a value - of False. -