From 2d2367fa22cda664adf3e8440f1382e5864bd15f Mon Sep 17 00:00:00 2001 From: Bob Callaway Date: Mon, 16 Dec 2013 14:35:09 -0500 Subject: [PATCH] Update NetApp volume driver docs to add table on extra specs, leverage updated config option docs, and general copy-editing. Change-Id: I05cc3807ecc741c476ffd8883fe2aded95afe580 Partial-Bug: 1255215 --- doc/common/tables/cinder-netapp.xml | 98 ----- .../tables/cinder-netapp_7mode_iscsi.xml | 60 +++ doc/common/tables/cinder-netapp_7mode_nfs.xml | 60 +++ .../tables/cinder-netapp_cdot_extraspecs.xml | 75 ++++ .../tables/cinder-netapp_cdot_iscsi.xml | 56 +++ doc/common/tables/cinder-netapp_cdot_nfs.xml | 64 +++ doc/common/tables/cinder-storage_netapp.xml | 28 -- .../drivers/netapp-volume-driver.xml | 371 ++++++++++-------- .../block-storage/drivers/xen-sm-driver.xml | 2 +- .../cinder.flagmappings | 29 +- 10 files changed, 548 insertions(+), 295 deletions(-) delete mode 100644 doc/common/tables/cinder-netapp.xml create mode 100644 doc/common/tables/cinder-netapp_7mode_iscsi.xml create mode 100644 doc/common/tables/cinder-netapp_7mode_nfs.xml create mode 100644 doc/common/tables/cinder-netapp_cdot_extraspecs.xml create mode 100644 doc/common/tables/cinder-netapp_cdot_iscsi.xml create mode 100644 doc/common/tables/cinder-netapp_cdot_nfs.xml delete mode 100644 doc/common/tables/cinder-storage_netapp.xml diff --git a/doc/common/tables/cinder-netapp.xml b/doc/common/tables/cinder-netapp.xml deleted file mode 100644 index dfc123bbeb..0000000000 --- a/doc/common/tables/cinder-netapp.xml +++ /dev/null @@ -1,98 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Description of configuration options for netapp
Configuration option=Default valueDescription
expiry_thres_minutes=720(IntOpt) Threshold minutes after which cache file can be cleaned.
netapp_login=None(StrOpt) Login user name for the storage 7-Mode controller/clustered Data ONTAP management.
netapp_password=None(StrOpt) Login password for the 7-Mode controller/clustered Data ONTAP management.
netapp_server_hostname=None(StrOpt) The management IP address for the 7-Mode controller or clustered Data ONTAP.
netapp_server_port=80(IntOpt) The 7-Mode controller/Clustered ONTAP data port to use for communication. - As a custom, 80 is used for HTTP and 443 is used for HTTPS communication. - The defaults should be changed if other ports are used for ONTAPI.
netapp_size_multiplier=1.2(FloatOpt) When creating volumes, the quantity to be - multiplied to the requested OpenStack volume size to ensure enough space is available on - the 7-Mode Controller/Clustered Data ONTAP Vserver.
netapp_storage_family=ontap_cluster(StrOpt) Storage family type. Valid values are ontap_7mode for using a 7-Mode controller - or ontap_cluster for a Clustered Data ONTAP.
netapp_storage_protocol=None(StrOpt) The storage protocol to be used. Valid options are nfs or iscsi, - but we recommended that you consult the detailed explanation. - If None is selected, nfs will be used.
netapp_transport_type=http(StrOpt) Transport protocol for communicating with the 7-Mode controller or Clustered Data ONTAP. - Supported protocols include http and https.
netapp_vfiler=None(StrOpt) The vFiler unit to be use for provisioning OpenStack Volumes. Use this only if using - MultiStore®.
netapp_volume_list=None(StrOpt) Comma separated list of NetApp volumes to - be used for provisioning on 7-Mode controller. This - option is used to restrict provisioning to the - specified NetApp controller volumes. In case this - option is not specified all NetApp controller volumes - except the controller root volume are used for - provisioning OpenStack volumes.
netapp_vserver=None(StrOpt) The Vserver on the cluster on which - provisioning of OpenStack volumes occurs. If using netapp_storage_protocol=nfs, - it is a mandatory parameter for storage service catalog support. - If specified the exports belonging to the - vserver will only be used for provisioning in future. - OpenStack volumes on exports not belonging to the vserver - will continue to function in a normal manner and recieve - Block Storage operations like snapshot creation etc.
thres_avl_size_perc_start=20(IntOpt) Threshold available percent to start cache cleaning.
thres_avl_size_perc_stop=60(IntOpt) Threshold available percent to stop cache cleaning.
- diff --git a/doc/common/tables/cinder-netapp_7mode_iscsi.xml b/doc/common/tables/cinder-netapp_7mode_iscsi.xml new file mode 100644 index 0000000000..0b24dfa8c8 --- /dev/null +++ b/doc/common/tables/cinder-netapp_7mode_iscsi.xml @@ -0,0 +1,60 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Description of configuration options for netapp_7mode_iscsi
Configuration option=Default valueDescription
netapp_login=None(StrOpt) Administrative user account name used to access the storage system.
netapp_password=None(StrOpt) Password for the administrative user account specified in the netapp_login option.
netapp_server_hostname=None(StrOpt) The hostname (or IP address) for the storage system.
netapp_server_port=80(IntOpt) The TCP port to use for communication with ONTAPI on the storage system. Traditionally, port 80 is used for HTTP and port 443 is used for HTTPS; however, this value should be changed if an alternate port has been configured on the storage system.
netapp_size_multiplier=1.2(FloatOpt) The quantity to be multiplied by the requested volume size to ensure enough space is available on the virtual storage server (Vserver) to fulfill the volume creation request.
netapp_storage_family=ontap_cluster(StrOpt) The storage family type used on the storage system; valid values are ontap_7mode for using Data ONTAP operating in 7-Mode or ontap_cluster for using clustered Data ONTAP.
netapp_storage_protocol=None(StrOpt) The storage protocol to be used on the data path with the storage system; valid values are iscsi or nfs.
netapp_transport_type=http(StrOpt) The transport protocol used when communicating with ONTAPI on the storage system. Valid values are http or https.
netapp_vfiler=None(StrOpt) The vFiler unit on which provisioning of block storage volumes will be done. This option is only used by the driver when connecting to an instance with a storage family of Data ONTAP operating in 7-Mode and the storage protocol selected is iSCSI. Only use this option when utilizing the MultiStore feature on the NetApp storage system.
netapp_volume_list=None(StrOpt) This option is only utilized when the storage protocol is configured to use iSCSI. This option is used to restrict provisioning to the specified controller volumes. Specify the value of this option to be a comma separated list of NetApp controller volume names to be used for provisioning.
+ \ No newline at end of file diff --git a/doc/common/tables/cinder-netapp_7mode_nfs.xml b/doc/common/tables/cinder-netapp_7mode_nfs.xml new file mode 100644 index 0000000000..16ed6fb565 --- /dev/null +++ b/doc/common/tables/cinder-netapp_7mode_nfs.xml @@ -0,0 +1,60 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Description of configuration options for netapp_7mode_nfs
Configuration option=Default valueDescription
expiry_thres_minutes=720(IntOpt) This option specifies the threshold for last access time for images in the NFS image cache. When a cache cleaning cycle begins, images in the cache that have not been accessed in the last M minutes, where M is the value of this parameter, will be deleted from the cache to create free space on the NFS share.
netapp_login=None(StrOpt) Administrative user account name used to access the storage system.
netapp_password=None(StrOpt) Password for the administrative user account specified in the netapp_login option.
netapp_server_hostname=None(StrOpt) The hostname (or IP address) for the storage system.
netapp_server_port=80(IntOpt) The TCP port to use for communication with ONTAPI on the storage system. Traditionally, port 80 is used for HTTP and port 443 is used for HTTPS; however, this value should be changed if an alternate port has been configured on the storage system.
netapp_storage_family=ontap_cluster(StrOpt) The storage family type used on the storage system; valid values are ontap_7mode for using Data ONTAP operating in 7-Mode or ontap_cluster for using clustered Data ONTAP.
netapp_storage_protocol=None(StrOpt) The storage protocol to be used on the data path with the storage system; valid values are iscsi or nfs.
netapp_transport_type=http(StrOpt) The transport protocol used when communicating with ONTAPI on the storage system. Valid values are http or https.
thres_avl_size_perc_start=20(IntOpt) If the percentage of available space for an NFS share has dropped below the value specified by this option, the NFS image cache will be cleaned.
thres_avl_size_perc_stop=60(IntOpt) When the percentage of available space on an NFS share has reached the percentage specified by this option, the driver will stop clearing files from the NFS image cache that have not been accessed in the last M minutes, where M is the value of the expiry_thres_minutes configuration option.
+ \ No newline at end of file diff --git a/doc/common/tables/cinder-netapp_cdot_extraspecs.xml b/doc/common/tables/cinder-netapp_cdot_extraspecs.xml new file mode 100644 index 0000000000..3c3c9ab4ec --- /dev/null +++ b/doc/common/tables/cinder-netapp_cdot_extraspecs.xml @@ -0,0 +1,75 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Description of extra specs options for NetApp Unified Driver with Clustered Data ONTAP
Extra specTypeDescription
netapp:raid_typeStringLimit the candidate volume list based on one of the following raid types: raid4, raid_dp.
netapp:disk_typeStringLimit 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_groupStringLimit the candidate volume list based on the name of a QoS policy group, which defines measurable Service Level Objectives + that apply to the storage objects with which the policy group is associated.
netapp_mirroredIf both the positive and negative specs for a pair are specified (e.g. 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.BooleanLimit the candidate volume list to only the ones that are mirrored on the storage controller.
netapp_unmirroredBooleanLimit the candidate volume list to only the ones that are not mirrored on the storage controller.
netapp_dedupBooleanLimit the candidate volume list to only the ones that have deduplication enabled on the storage controller.
netapp_nodedupBooleanLimit the candidate volume list to only the ones that have deduplication disabled on the storage controller.
netapp_compressionBooleanLimit the candidate volume list to only the ones that have compression enabled on the storage controller.
netapp_nocompressionBooleanLimit the candidate volume list to only the ones that have compression disabled on the storage controller.
netapp_thin_provisionedBooleanLimit the candidate volume list to only the ones that support thin provisioning on the storage controller.
netapp_thick_provisionedBooleanLimit the candidate volume list to only the ones that support thick provisioning on the storage controller.
+ diff --git a/doc/common/tables/cinder-netapp_cdot_iscsi.xml b/doc/common/tables/cinder-netapp_cdot_iscsi.xml new file mode 100644 index 0000000000..2eae019716 --- /dev/null +++ b/doc/common/tables/cinder-netapp_cdot_iscsi.xml @@ -0,0 +1,56 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Description of configuration options for netapp_cdot_iscsi
Configuration option=Default valueDescription
netapp_login=None(StrOpt) Administrative user account name used to access the storage system.
netapp_password=None(StrOpt) Password for the administrative user account specified in the netapp_login option.
netapp_server_hostname=None(StrOpt) The hostname (or IP address) for the storage system.
netapp_server_port=80(IntOpt) The TCP port to use for communication with ONTAPI on the storage system. Traditionally, port 80 is used for HTTP and port 443 is used for HTTPS; however, this value should be changed if an alternate port has been configured on the storage system.
netapp_size_multiplier=1.2(FloatOpt) The quantity to be multiplied by the requested volume size to ensure enough space is available on the virtual storage server (Vserver) to fulfill the volume creation request.
netapp_storage_family=ontap_cluster(StrOpt) The storage family type used on the storage system; valid values are ontap_7mode for using Data ONTAP operating in 7-Mode or ontap_cluster for using clustered Data ONTAP.
netapp_storage_protocol=None(StrOpt) The storage protocol to be used on the data path with the storage system; valid values are iscsi or nfs.
netapp_transport_type=http(StrOpt) The transport protocol used when communicating with ONTAPI on the storage system. Valid values are http or https.
netapp_vserver=None(StrOpt) This option specifies the virtual storage server (Vserver) name on the storage cluster on which provisioning of block storage volumes should occur. If using the NFS storage protocol, this parameter is mandatory for storage service catalog support (utilized by Cinder volume type extra_specs support). If this option is specified, the exports belonging to the Vserver will only be used for provisioning in the future. Block storage volumes on exports not belonging to the Vserver specified by this option will continue to function normally.
+ \ No newline at end of file diff --git a/doc/common/tables/cinder-netapp_cdot_nfs.xml b/doc/common/tables/cinder-netapp_cdot_nfs.xml new file mode 100644 index 0000000000..5a129eb435 --- /dev/null +++ b/doc/common/tables/cinder-netapp_cdot_nfs.xml @@ -0,0 +1,64 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Description of configuration options for netapp_cdot_nfs
Configuration option=Default valueDescription
expiry_thres_minutes=720(IntOpt) This option specifies the threshold for last access time for images in the NFS image cache. When a cache cleaning cycle begins, images in the cache that have not been accessed in the last M minutes, where M is the value of this parameter, will be deleted from the cache to create free space on the NFS share.
netapp_login=None(StrOpt) Administrative user account name used to access the storage system.
netapp_password=None(StrOpt) Password for the administrative user account specified in the netapp_login option.
netapp_server_hostname=None(StrOpt) The hostname (or IP address) for the storage system.
netapp_server_port=80(IntOpt) The TCP port to use for communication with ONTAPI on the storage system. Traditionally, port 80 is used for HTTP and port 443 is used for HTTPS; however, this value should be changed if an alternate port has been configured on the storage system.
netapp_storage_family=ontap_cluster(StrOpt) The storage family type used on the storage system; valid values are ontap_7mode for using Data ONTAP operating in 7-Mode or ontap_cluster for using clustered Data ONTAP.
netapp_storage_protocol=None(StrOpt) The storage protocol to be used on the data path with the storage system; valid values are iscsi or nfs.
netapp_transport_type=http(StrOpt) The transport protocol used when communicating with ONTAPI on the storage system. Valid values are http or https.
netapp_vserver=None(StrOpt) This option specifies the virtual storage server (Vserver) name on the storage cluster on which provisioning of block storage volumes should occur. If using the NFS storage protocol, this parameter is mandatory for storage service catalog support (utilized by Cinder volume type extra_specs support). If this option is specified, the exports belonging to the Vserver will only be used for provisioning in the future. Block storage volumes on exports not belonging to the Vserver specified by this option will continue to function normally.
thres_avl_size_perc_start=20(IntOpt) If the percentage of available space for an NFS share has dropped below the value specified by this option, the NFS image cache will be cleaned.
thres_avl_size_perc_stop=60(IntOpt) When the percentage of available space on an NFS share has reached the percentage specified by this option, the driver will stop clearing files from the NFS image cache that have not been accessed in the last M minutes, where M is the value of the expiry_thres_minutes configuration option.
+ \ No newline at end of file diff --git a/doc/common/tables/cinder-storage_netapp.xml b/doc/common/tables/cinder-storage_netapp.xml deleted file mode 100644 index 90f3890424..0000000000 --- a/doc/common/tables/cinder-storage_netapp.xml +++ /dev/null @@ -1,28 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - -
Description of configuration options for storage_netapp
Configuration option=Default valueDescription
netapp_login=None(StrOpt) User name for the storage controller
netapp_vfiler=None(StrOpt) Vfiler to use for provisioning
- \ No newline at end of file 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 ce57f10eb0..f25a70e33d 100644 --- a/doc/config-reference/block-storage/drivers/netapp-volume-driver.xml +++ b/doc/config-reference/block-storage/drivers/netapp-volume-driver.xml @@ -3,25 +3,26 @@ xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"> NetApp unified driver - NetApp unified driver is a block storage driver that - supports multiple storage families and storage protocols. The - storage family corresponds to storage systems built on - different technologies like 7-Mode and clustered Data ONTAP®. - The storage protocol refers to the protocol used to initiate - data storage and access operations on those storage systems - like iSCSI and NFS. NetApp unified driver can be configured to - provision and manage OpenStack volumes on a given storage - family for the specified storage protocol. The OpenStack - volumes can then be used for accessing and storing data using - the storage protocol on the storage family system. NetApp - unified driver is an extensible interface that can support new - storage families and storage protocols. + The NetApp® unified driver is a block storage driver that + supports multiple storage families and protocols. A storage + family corresponds to storage systems built on different + NetApp technologies such as clustered Data ONTAP® and Data + ONTAP operating in 7-Mode. The storage protocol refers to + the protocol used to initiate data storage and access + operations on those storage systems like iSCSI and NFS. The + NetApp unified driver can be configured to provision and + manage OpenStack volumes on a given storage family using a + specified storage protocol. The OpenStack volumes can then be + used for accessing and storing data using the storage + protocol on the storage family system. The NetApp unified + driver is an extensible interface that can support new + storage families and protocols.
NetApp clustered Data ONTAP storage family The NetApp clustered Data ONTAP storage family represents a configuration group which provides OpenStack compute instances access to clustered Data ONTAP storage - systems. At present it can be configured in cinder to work + systems. At present it can be configured in Cinder to work with iSCSI and NFS storage protocols.
NetApp iSCSI configuration for clustered Data @@ -29,227 +30,289 @@ <para>The NetApp iSCSI configuration for clustered Data ONTAP is an interface from OpenStack to clustered Data ONTAP storage systems for provisioning and managing - the SAN block storage entity, that is, NetApp LUN - which can be accessed using iSCSI protocol.</para> + the SAN block storage entity; that is, a NetApp LUN + which can be accessed using the iSCSI protocol.</para> <para>The iSCSI configuration for clustered Data ONTAP is - a direct interface from OpenStack to clustered Data - ONTAP and it does not require additional management - software to achieve the desired functionality. It uses - NetApp APIs to interact with the clustered Data - ONTAP.</para> + a direct interface from Cinder to the clustered Data + ONTAP instance and as such does not require additional + management software to achieve the desired functionality. + It uses NetApp APIs to interact with the clustered Data + ONTAP instance.</para> <simplesect> <title>Configuration options for clustered Data ONTAP family with iSCSI protocol - Set the volume driver, storage family and - storage protocol to NetApp unified driver, - clustered Data ONTAP and iSCSI respectively by + Configure the volume driver, storage family and + storage protocol to the NetApp unified driver, + clustered Data ONTAP, and iSCSI respectively by setting the volume_driver, netapp_storage_family and netapp_storage_protocol options in cinder.conf as follows: - + volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver netapp_storage_family=ontap_cluster netapp_storage_protocol=iscsi + netapp_vserver=openstack-vserver + netapp_server_hostname=myhostname + netapp_server_port=80 + netapp_login=username + netapp_password=password - See OpenStack NetApp community for - detailed information on available configuration - options. + You must override the default value of + netapp_storage_protocol with + iscsi in order to utilize the + iSCSI protocol. + + If you specify an account in the + netapp_login that only has virtual + storage server (Vserver) administration priviledges + (rather than cluster-wide administration priviledges), + some advanced features of the NetApp unified driver + will not work and you may see warnings in the Cinder + logs. + For more information on these options and + other deployment and operational scenarios, visit the + + OpenStack NetApp community.
NetApp NFS configuration for clustered Data ONTAP The NetApp NFS configuration for clustered Data - ONTAP is an interface from OpenStack to clustered Data + ONTAP is an interface from OpenStack to a clustered Data ONTAP system for provisioning and managing OpenStack volumes on NFS exports provided by the clustered Data - ONTAP system which can then be accessed using NFS - protocol. - The NFS configuration for clustered Data ONTAP does - not require any additional management software to + ONTAP system that are accessed using the NFS protocol. + The NFS configuration for clustered Data ONTAP is a direct + interface from Cinder to the clustered Data ONTAP instance and + as such does not require any additional management software to achieve the desired functionality. It uses NetApp APIs - to interact with the clustered Data ONTAP. + to interact with the clustered Data ONTAP instance. Configuration options for the clustered Data ONTAP family with NFS protocol - Set the volume driver, storage family and + Configure the volume driver, storage family and storage protocol to NetApp unified driver, - clustered Data ONTAP and NFS respectively by + clustered Data ONTAP, and NFS respectively by setting the volume_driver, netapp_storage_family and netapp_storage_protocol options in cinder.conf as follows: - + volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver netapp_storage_family=ontap_cluster netapp_storage_protocol=nfs + netapp_vserver=openstack-vserver + netapp_server_hostname=myhostname + netapp_server_port=80 + netapp_login=username + netapp_password=password - See OpenStack NetApp community for - detailed information on available configuration - options. + + If you specify an account in the + netapp_login that only has virtual + storage server (Vserver) administration priviledges + (rather than cluster-wide administration priviledges), + some advanced features of the NetApp unified driver + will not work and you may see warnings in the Cinder + logs. + For more information on these options and other deployment and operational scenarios, visit the OpenStack NetApp community.
+
+ NetApp-supported extra specs for clustered Data + ONTAP + Extra specs allow individual vendors to specify additional + filter criteria which the Cinder scheduler can use when evaluating + which volume node should fulfill a volume provisioning request. + When using the NetApp unified driver with a clustered Data ONTAP + storage system, you can leverage extra specs with Cinder volume types + to ensure that Cinder volumes are created on storage backends that + have certain properties (e.g. QoS, mirroring, compression) configured. + Extra specs are associated with Cinder volume types, so that when + users request volumes of a particular volume type, they will be + created on storage backends that meet the list of requirements (e.g. + available space, extra specs, etc). You can use the specs in the + table later in this section when defining Cinder volume types using the + cinder 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 Cinder 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. +
- NetApp 7-Mode Data ONTAP storage family - The NetApp 7-Mode Data ONTAP storage family represents a - configuration group which provides OpenStack compute - instances access to 7-Mode storage systems. At present it - can be configured in cinder to work with iSCSI and NFS + NetApp Data ONTAP operating in 7-Mode storage family + The NetApp Data ONTAP operating in 7-Mode storage family + represents a configuration group which provides OpenStack + compute instances access to 7-Mode storage systems. At present + it can be configured in Cinder to work with iSCSI and NFS storage protocols.
- NetApp iSCSI configuration for 7-Mode storage - controller - The NetApp iSCSI configuration for 7-Mode Data ONTAP - is an interface from OpenStack to 7-Mode storage - systems for provisioning and managing the SAN block - storage entity, that is, NetApp LUN which can be - accessed using iSCSI protocol. - The iSCSI configuration for 7-Mode Data ONTAP is a - direct interface from OpenStack to 7-Mode storage - system and it does not require additional management - software to achieve the desired functionality. It uses - NetApp APIs to interact with the 7-Mode storage - system. + NetApp iSCSI configuration for Data ONTAP operating in + 7-Mode + The NetApp iSCSI configuration for Data ONTAP operating + in 7-Mode is an interface from OpenStack to Data ONTAP + operating in 7-Mode storage systems for provisioning and + managing the SAN block storage entity, that is, a + LUN which can be accessed using iSCSI protocol. + The iSCSI configuration for Data ONTAP operating in 7-Mode + is a direct interface from OpenStack to Data ONTAP operating + in 7-Mode storage system and it does not require additional + management software to achieve the desired functionality. It + uses NetApp ONTAPI to interact with the Data ONTAP operating + in 7-Mode storage system. - Configuration options for the 7-Mode Data ONTAP - storage family with iSCSI protocol - Set the volume driver, storage family and - storage protocol to NetApp unified driver, 7-Mode - Data ONTAP and iSCSI respectively by setting the + Configuration options for the Data ONTAP operating in + 7-Mode storage family with iSCSI protocol + Configure the volume driver, storage family and + storage protocol to the NetApp unified driver, Data + ONTAP operating in 7-Mode, and iSCSI respectively by + setting the volume_driver, netapp_storage_family and netapp_storage_protocol options in cinder.conf as follows: - + volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver netapp_storage_family=ontap_7mode netapp_storage_protocol=iscsi + netapp_server_hostname=myhostname + netapp_server_port=80 + netapp_login=username + netapp_password=password - See OpenStack NetApp community for - detailed information on available configuration - options. + You must override the default value of + netapp_storage_protocol with + iscsi in order to utilize the + iSCSI protocol. + + For more information on these options and other deployment and operational scenarios, visit the OpenStack NetApp community.
- NetApp NFS configuration for 7-Mode Data - ONTAP - The NetApp NFS configuration for 7-Mode Data ONTAP - is an interface from OpenStack to 7-Mode storage - system for provisioning and managing OpenStack volumes - on NFS exports provided by the 7-Mode storage system - which can then be accessed using NFS protocol. - The NFS configuration for 7-Mode Data ONTAP does not - require any additional management software to achieve - the desired functionality. It uses NetApp APIs to - interact with the 7-Mode storage system. + NetApp NFS configuration for Data ONTAP operating in + 7-Mode + The NetApp NFS configuration for Data ONTAP operating in + 7-Mode is an interface from OpenStack to Data ONTAP + operating in 7-Mode storage system for provisioning and + managing OpenStack volumes on NFS exports provided by the + Data ONTAP operating in 7-Mode storage system which can + then be accessed using NFS protocol. + The NFS configuration for Data ONTAP operating in 7-Mode + is a direct interface from Cinder to the Data ONTAP + operating in 7-Mode instance and as such does not require + any additional management software to achieve the desired + functionality. It uses NetApp ONTAPI to interact with the + Data ONTAP operating in 7-Mode storage system. - Configuration options for the 7-Mode Data ONTAP - family with NFS protocol - Set the volume driver, storage family and - storage protocol to NetApp unified driver, 7-Mode - Data ONTAP and NFS respectively by setting the + Configuration options for the Data ONTAP operating + in 7-Mode family with NFS protocol + Configure the volume driver, storage family and + storage protocol to the NetApp unified driver, Data + ONTAP operating in 7-Mode, and NFS respectively by + setting the volume_driver, netapp_storage_family and netapp_storage_protocol options in cinder.conf as follows: - + volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver netapp_storage_family=ontap_7mode netapp_storage_protocol=nfs + netapp_server_hostname=myhostname + netapp_server_port=80 + netapp_login=username + netapp_password=password - See OpenStack NetApp community for - detailed information on available configuration - options. + + For more information on these options and other deployment and operational scenarios, visit the OpenStack NetApp community.
-
- Driver options - -
- Upgrading NetApp drivers to Havana - NetApp has introduced a new unified driver in Havana for - configuring different storage families and storage + Upgrading prior NetApp drivers to the NetApp unified driver + NetApp introduced a new unified block storage driver in + Havana for configuring different storage families and storage protocols. This requires defining upgrade path for NetApp - drivers which existed in a previous release like Grizzly. + drivers which existed in releases prior to Havana. This section covers the upgrade configuration for NetApp - drivers and lists deprecated NetApp drivers. + drivers to the new unified configuration and a list of + deprecated NetApp drivers.
Upgraded NetApp drivers - This section shows upgrade configuration in Havana - for NetApp drivers in Grizzly. + This section describes how to update Cinder + configuration from a pre-Havana release to the new unified + driver format. Driver upgrade configuration - NetApp iSCSI direct driver for clustered - Data ONTAP in Grizzly - - volume_driver=cinder.volume.drivers.netapp.iscsi.NetAppDirectCmodeISCSIDriver + NetApp iSCSI direct driver for Clustered + Data ONTAP in Grizzly (or earlier) + +volume_driver=cinder.volume.drivers.netapp.iscsi.NetAppDirectCmodeISCSIDriver NetApp Unified Driver configuration - - volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver - netapp_storage_family=ontap_cluster - netapp_storage_protocol=iscsi + +volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver +netapp_storage_family=ontap_cluster +netapp_storage_protocol=iscsi - NetApp NFS direct driver for clustered - Data ONTAP in Grizzly - - volume_driver=cinder.volume.drivers.netapp.nfs.NetAppDirectCmodeNfsDriver + NetApp NFS direct driver for Clustered + Data ONTAP in Grizzly (or earlier) + +volume_driver=cinder.volume.drivers.netapp.nfs.NetAppDirectCmodeNfsDriver NetApp Unified Driver configuration - - volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver - netapp_storage_family=ontap_cluster - netapp_storage_protocol=nfs + +volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver +netapp_storage_family=ontap_cluster +netapp_storage_protocol=nfs - NetApp iSCSI direct driver for 7-Mode - storage controller in Grizzly - - volume_driver=cinder.volume.drivers.netapp.iscsi.NetAppDirect7modeISCSIDriver + NetApp iSCSI direct driver for Data ONTAP + operating in 7-Mode storage controller in + Grizzly (or earlier) + +volume_driver=cinder.volume.drivers.netapp.iscsi.NetAppDirect7modeISCSIDriver NetApp Unified Driver configuration - - volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver - netapp_storage_family=ontap_7mode - netapp_storage_protocol=iscsi + +volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver +netapp_storage_family=ontap_7mode +netapp_storage_protocol=iscsi - NetApp NFS direct driver for 7-Mode - storage controller in Grizzly - - volume_driver=cinder.volume.drivers.netapp.nfs.NetAppDirect7modeNfsDriver + NetApp NFS direct driver for Data ONTAP + operating in 7-Mode storage controller in + Grizzly (or earlier) + +volume_driver=cinder.volume.drivers.netapp.nfs.NetAppDirect7modeNfsDriver NetApp Unified Driver configuration - - volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver - netapp_storage_family=ontap_7mode - netapp_storage_protocol=nfs + +volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver +netapp_storage_family=ontap_7mode +netapp_storage_protocol=nfs @@ -258,44 +321,44 @@
Deprecated NetApp drivers - This section lists the NetApp drivers in Grizzly + This section lists the NetApp drivers in previous releases that are deprecated in Havana. NetApp iSCSI driver for clustered Data ONTAP. - - volume_driver=cinder.volume.drivers.netapp.iscsi.NetAppCmodeISCSIDriver + +volume_driver=cinder.volume.drivers.netapp.iscsi.NetAppCmodeISCSIDriver NetApp NFS driver for clustered Data ONTAP. - - volume_driver=cinder.volume.drivers.netapp.nfs.NetAppCmodeNfsDriver + +volume_driver=cinder.volume.drivers.netapp.nfs.NetAppCmodeNfsDriver - NetApp iSCSI driver for 7-Mode storage - controller. - - volume_driver=cinder.volume.drivers.netapp.iscsi.NetAppISCSIDriver + NetApp iSCSI driver for Data ONTAP operating in + 7-Mode storage controller. + +volume_driver=cinder.volume.drivers.netapp.iscsi.NetAppISCSIDriver - NetApp NFS driver for 7-Mode storage - controller. - - volume_driver=cinder.volume.drivers.netapp.nfs.NetAppNFSDriver + NetApp NFS driver for Data ONTAP operating in + 7-Mode storage controller. + +volume_driver=cinder.volume.drivers.netapp.nfs.NetAppNFSDriver - See See the OpenStack NetApp community for - information on supporting deprecated NetApp - drivers in Havana. + support information on deprecated NetApp + drivers in the Havana release.
diff --git a/doc/config-reference/block-storage/drivers/xen-sm-driver.xml b/doc/config-reference/block-storage/drivers/xen-sm-driver.xml index ef10f7b170..ed0133f98d 100644 --- a/doc/config-reference/block-storage/drivers/xen-sm-driver.xml +++ b/doc/config-reference/block-storage/drivers/xen-sm-driver.xml @@ -63,7 +63,7 @@ Back-end: A term for a particular storage back-end. This - could be iSCSI, NFS, Netapp etc. + could be iSCSI, NFS, NetApp etc.