iSCSI Configuration .. _asar2-iscsi-fc-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 |
|---|---|---|---|
|
Required |
The hostname or IP address for the storage system. |
|
|
Required |
The storage protocol to be used. Valid options: |
|
|
Optional |
|
The storage family type used on the storage system. |
|
Required |
Administrative user account name for the storage system. |
|
|
Required |
Password for the administrative user account. |
|
|
Required |
The storage virtual machine (SVM) name on the storage cluster. |
|
|
Optional |
|
Amount of over-provisioning to allow when thin provisioning is used. |
|
Optional |
|
Amount of total capacity of a storage pool reserved and not used for provisioning. |
|
Optional |
|
Use REST client for ONTAP communication if supported. |
|
Optional |
|
Indicates ASA r2 platform support. |
|
Required |
|
The transport protocol used when communicating with the storage system or proxy server. Valid options include |
|
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 |
|
Optional |
|
If set to |
|
Optional |
|
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.
This document is licensed under Apache 2.0 license.