Deployment Choices: ASA r2 with iSCSI, FC, and NVMe

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

Deployment Choices: 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_server_port=443
netapp_transport_type=https
netapp_ssl_cert_path=/etc/cinder/ontap_ca.pem
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

https

The transport protocol used when communicating with the storage system or proxy server. Valid options include http and https

netapp_ssl_cert_path

Optional

(see description)

The path to a CA_BUNDLE file or directory with certificates of trusted CA. If set to a directory, it must have been processed using

netapp_ssl_cert_verify

Optional

True

If set to False, the SSL certificate of the storage system will not be verified.

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.