NetApp Unified Driver for ONTAP ASA r2 with iSCSI, FC, and NVMe

updated: 2025-09-29 06:50

iSCSI Configuration .. _asar2-iscsi-fc-nvme:

NetApp Unified Driver for ONTAP ASA r2 with iSCSI, FC, and NVMeΒΆ

The NetApp unified driver for ONTAP ASA r2 supports iSCSI, Fibre Channel (FC), and NVMe protocols and NFS protocol is not supported. The extra option netapp_disaggregated_platform indicates ASA r2 support.

To set up the NetApp ONTAP ASA r2 driver for Cinder, add the following stanza to the Cinder configuration file (cinder.conf):

[myASAr2Backend]
volume_backend_name=myASAr2Backend
volume_driver=cinder.volume.drivers.netapp.common.NetAppDriver
netapp_server_hostname=hostname
netapp_storage_protocol=protocol
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
netapp_use_legacy_client=False
netapp_disaggregated_platform=True
netapp_driver_reports_provisioned_capacity=True

  • Ensure the value of the enabled_backends option in the [DEFAULT] stanza includes the name of the backend stanza.

  • The value of netapp_storage_protocol MUST be set to iscsi for iSCSI configuration.

  • The option netapp_disaggregated_platform MUST be set to True to indicate ASA r2 support.

Option | Type | Default Value | Description

netapp_server_hostname | Required | | The hostname or IP address for the storage system.

netapp_storage_protocol | Required | | The storage protocol to be used. Valid options: iscsi, fc, nvme.

netapp_storage_family | Optional | ontap_cluster | The storage family type used on the storage system.

netapp_login | Required | | Administrative user account name for the storage system.

netapp_password | Required | | Password for the administrative user account.

netapp_vserver | Required | | The storage virtual machine (SVM) name on the storage cluster.

max_over_subscription_ratio | Optional | 2.0 | Amount of over-provisioning to allow when thin provisioning is used.

reserved_percentage | Optional | 5 | Amount of total capacity of a storage pool reserved and not used for provisioning.

netapp_use_legacy_client | Optional | False | Use REST client for ONTAP communication if supported.

netapp_disaggregated_platform | Optional | True | Indicates ASA r2 platform support.

netapp_transport_type | Required | http | Transport protocol for communicating with the storage system.

netapp_driver_reports_provisioned_capacity | Optional | True | Driver reports provisioned capacity.

Caution

The option netapp_disaggregated_platform must be set to True for ASA r2 support. If not set, this value defaults to False, which means ASA r2 platform features are not enabled and the backend operates as a non-ASA r2 platform.

Important

For ONTAP ASA r2, netapp_use_legacy_client must be set to False as ZAPI support is deprecated. Only the REST client is supported for this platform.

For this release, only the ONTAP admin account is supported for driver configuration. SVM admin accounts are not supported.

Note

Supported features for ASA r2 in this release include basic provisioning operations such as volume create, delete, and extend and Nova specific workflows for attaching and detaching Cinder volumes are also supported.

Refer to the NetApp ONTAP documentation and Cinder driver documentation for additional options and advanced configuration details.

updated: 2025-09-29 06:50

This document is licensed under Apache 2.0 license.

found an error? report a bug questions?