NetApp Unified Driver for Clustered Data ONTAP with iSCSI

The NetApp unified driver for clustered Data ONTAP with iSCSI is a driver interface from OpenStack Cinder to NetApp clustered Data ONTAP storage controllers to accomplish provisioning and management of a storage-area network (SAN) block storage entity; that is, a NetApp LUN that uses the iSCSI protocol.

 Configuration Options

To set up the NetApp clustered Data ONTAP iSCSI driver for Cinder, the following stanza should be added to the Cinder configuration file (cinder.conf):

[myIscsiBackend] 1
volume_backend_name=myIscsiBackend
volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver
netapp_server_hostname=hostname
netapp_server_port=80
netapp_storage_protocol=iscsi 2
netapp_storage_family=ontap_cluster
netapp_login=admin_username
netapp_password=admin_password
netapp_vserver=svm_name
            

 1

Be sure that the value of the enabled_backends option in the [DEFAULT] stanza includes the name of the stanza you chose for the backend.

 2

The value of netapp_storage_protocol MUST be set to iscsi, as the default value for this option is nfs.

Table 4.7, “Configuration options for clustered Data ONTAP with iSCSI” lists the configuration options available for the unified driver for a clustered Data ONTAP deployment that uses the iSCSI storage protocol.

Table 4.7. Configuration options for clustered Data ONTAP with iSCSI
Option Type Default Value Description
netapp_server_hostname Required The hostname or IP address for the storage system or proxy server. The value of this option should be the IP address of either the cluster management LIF or the SVM management LIF.
netapp_server_port Optional 80 The TCP port to use for communication with the storage system or proxy server. If not specified, Data ONTAP drivers will use 80 for HTTP and 443 for HTTPS; E-Series will use 8080 for HTTP and 8443 for HTTPS.
netapp_login Required Administrative user account name used to access the storage system or proxy server.
netapp_password Required Password for the administrative user account specified in the netapp_login option.
netapp_storage_protocol Required nfs The storage protocol to be used. Valid options are nfs or iscsi. If None is specified or the option is omitted, nfs will be used.
netapp_transport_type Optional http Transport protocol for communicating with the storage system or proxy server. Valid options include http and https.
netapp_size_multiplier Optional 1.2 When creating volumes, the quantity to be multiplied to the requested OpenStack volume size to ensure enough space is available on the SVM (aka Vserver). This value is currently only used when ISCSI has been selected as the storage protocol to be used.
netapp_vserver Optional This option specifies the storage virtual machine (previously called a Vserver) name on the storage cluster on which provisioning of block storage volumes should occur. If the NFS storage protocol is used, 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 SVM will only be used for provisioning in the future. Block storage volumes on exports not belonging to the SVM specified by this option will continue to function normally.
netapp_storage_family Optional ontap_cluster The storage family type used on the storage system; valid values are ontap_7mode for Data ONTAP operating in 7-Mode, ontap_cluster for clustered Data ONTAP, or eseries for E-Series.
[Caution]Caution

If you specify an account in the netapp_login option that only has SVM administration privileges (rather than cluster administration privileges), some advanced features of the NetApp unified driver will not work and you may see warnings in the Cinder logs. See the section called “Account Permission Considerations” for more details on the required access level permissions for an SVM admin account.



loading table of contents...