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.

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 with iSCSI and NFS storage protocols.

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, a NetApp LUN which can be accessed using the iSCSI protocol. The iSCSI configuration for clustered Data ONTAP is 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. 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 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 privileges (rather than cluster-wide administration privileges), 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.

The NetApp NFS configuration for 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 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 instance. Configure the volume driver, storage family and storage protocol to NetApp unified driver, 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 If you specify an account in the netapp_login that only has virtual storage server (Vserver) administration privileges (rather than cluster-wide administration privileges), 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.

Extra specs enable vendors to specify extra filter criteria that the Block Storage scheduler uses when it determines which volume node should fulfill a volume provisioning request. When you use 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 back ends that have certain properties. For example, when you configure QoS, mirroring, or compression for a storage back end. Extra specs are associated with Cinder volume types, so that when users request volumes of a particular volume type, the volumes are created on storage back ends that meet the list of requirements. For example, the back ends have the available space or extra specs. You can use the specs in the following table when you define Cinder volume types by 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.

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.

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. 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 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.

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. 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 For more information on these options and other deployment and operational scenarios, visit the OpenStack NetApp community.

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 releases prior to Havana. This section covers the upgrade configuration for NetApp drivers to the new unified configuration and a list of deprecated NetApp drivers.

This section describes how to update Cinder configuration from a pre-Havana release to the new unified driver format. 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 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 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 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

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 NetApp NFS driver for clustered Data ONTAP. volume_driver=cinder.volume.drivers.netapp.nfs.NetAppCmodeNfsDriver NetApp iSCSI driver for Data ONTAP operating in 7-Mode storage controller. volume_driver=cinder.volume.drivers.netapp.iscsi.NetAppISCSIDriver NetApp NFS driver for Data ONTAP operating in 7-Mode storage controller. volume_driver=cinder.volume.drivers.netapp.nfs.NetAppNFSDriver See the OpenStack NetApp community for support information on deprecated NetApp drivers in the Havana release.