NetApp Unified Driver for ONTAP with Fibre Channel

NetApp Unified Driver for ONTAP with Fibre Channel

The NetApp unified driver for ONTAP with Fibre Channel is a driver interface from OpenStack Cinder to NetApp 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 Fibre Channel protocol.

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

[myFCBackend]
volume_backend_name=myFCBackend
volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver
netapp_server_hostname=hostname
netapp_server_port=80
netapp_storage_protocol=fc
netapp_storage_family=ontap_cluster
netapp_login=admin_username
netapp_password=admin_password
netapp_vserver=svm_name
max_over_subscription_ratio=1.0
reserved_percentage=5
  • 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.
  • The value of netapp_storage_protocol MUST be set to fc

Table 4.22, “Configuration options for ONTAP with Fibre Channel” below lists the configuration options available for the unified driver for an ONTAP deployment that uses the Fibre Channel storage protocol.

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   The TCP port to use for communication with the storage system or proxy server. If not specified, ONTAP drivers will use 80 for HTTP and 443 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   The storage protocol to be used. Valid options are nfs, iscsi or fc.
netapp_transport_type Required 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 Required   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.
netapp_storage_family Optional ontap_cluster The storage family type used on the storage system; valid values are ontap_cluster for ONTAP systems.
netapp_pool_name_search_pattern Optional (.+) This option is only utilized when the Cinder driver is configured to use iSCSI or Fibre Channel. It is used to restrict provisioning to the specified FlexVol volumes. Specify the value of this option as a regular expression which will be applied to the names of FlexVol volumes from the storage backend which represent pools in Cinder. ^ (beginning of string) and $ (end of string) are implicitly wrapped around the regular expression specified before filtering.
netapp_lun_space_reservation Optional enabled This option specifies whether space will be reserved when creating Cinder volumes on NetApp backends using the iSCSI or FC storage protocols. If this option is set to enabled, LUNs created during volume creation or volume cloning workflows will always be thick provisioned. If this option is set to disabled, LUNs created during volume creation or volume cloning workflows will always be thin provisioned. Note that this option does not affect the implementation of Cinder snapshots, where the LUN clone that represents the snapshot will always be thin provisioned. Valid options are enabled and disabled.
reserved_percentage Optional 0 This option represents the amount of total capacity of a storage pool that will be reserved and cannot be utilized for provisioning Cinder volumes.
max_over_subscription_ratio Optional 20.0 This option is defined as a float, and specifies the amount of over-provisioning to allow when thin provisioning is being used in the storage pool. A value of 1.0 will mean that the provisioned capacity will not be able to exceed the total capacity, while larger values will result in increased levels of allowed over-provisioning.
filter_function Optional (see description) This option may be used to override the default filter function, which prevents Cinder from placing new volumes on storage controllers that may become overutilized. The default value is “capabilities.utilization < 70”.
goodness_function Optional (see description) This option may be used to override the default goodness function, which allows Cinder to place new volumes on lesser-utilized storage controllers. The default value is “100 - capabilities.utilization”.
trace_flags Optional   This option is a comma-separated list of options (valid values include method and api) that controls which trace info is written to the Cinder logs when the debug level is set to True.
netapp_api_trace_pattern Optional (.+) A regular expression to limit the API tracing. This option is honored only if enabling api tracing with the trace_flags option. By default, all APIs will be traced.

Table 4.22. Configuration options for ONTAP with Fibre Channel

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.

Important

In order for Fibre Channel to be set up correctly, you also need to set up Fibre Channel zoning for your backends. See the section called “Fibre Channel & cinder.conf” for more details on configuring Fibre Channel zoning.