NetApp Unified Driver for Clustered Data ONTAP with Share Server management

The NetApp unified driver for clustered Data ONTAP with share server management is a driver interface from OpenStack Manila to NetApp clustered Data ONTAP storage controllers to accomplish provisioning and management of shared file systems across the scope of the entire cluster. This driver will create a new storage virtual machine (SVM) for each share server that is requested by the Manila service. This driver also creates new data logical interfaces (LIFs) that provide access for clients on a specific share network to access shared file systems exported from the share server.

Configuration Options

To set up the NetApp clustered Data ONTAP driver with Share Server management, the following stanza should be added to the Manila configuration file (manila.conf):

[cdotMultipleSVM] 
share_backend_name=cdotMultipleSVM
share_driver=manila.share.drivers.netapp.common.NetAppDriver
driver_handles_share_servers=True 
netapp_storage_family=ontap_cluster
netapp_server_hostname=hostname
netapp_server_port=80
netapp_login=admin_username
netapp_password=admin_password
netapp_transport_type=https
netapp_root_volume_aggregate=aggr1
netapp_aggregate_name_search_pattern=^((?!aggr0).)*$

	Be sure that the value of the `enabled_share_backends` option in the `[DEFAULT]` stanza includes the name of the stanza you chose for the backend.
	The value of `driver_handles_share_servers` MUST be set to `True` if you want the driver to manage share servers.

Table 6.14, “Configuration options for clustered Data ONTAP with Share Server management” lists the configuration options available for the unified driver for a clustered Data ONTAP deployment that manages share servers.

Table 6.14. Configuration options for clustered Data ONTAP with Share Server management
Option	Type	Default Value	Description
`driver_handles_share_servers`	Required		Denotes whether the driver should handle the responsibility of managing share servers. This must be set to `true` if the driver is to manage share servers.
`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 the cluster management LIF.
`netapp_server_port`	Optional		The TCP port to use for communication with the storage system or proxy server. If not specified, Data ONTAP drivers will use 80 for HTTP and 443 for HTTPS.
`netapp_login`	Required		Administrative user account name used to access the storage system.
`netapp_password`	Required		Password for the administrative user account specified in the `netapp_login` option.
`netapp_transport_type`	Required	`http`	Transport protocol for communicating with the storage system or proxy server. Valid options include `http` and `https`.
`netapp_storage_family`	Required	`ontap_cluster`	The storage family type used on the storage system; valid values are `ontap_cluster` for clustered Data ONTAP.
`netapp_root_volume_aggregate`	Required		This option specifies name of the aggregate upon which the root volume should be placed when a new SVM is created to correspond to a Manila share server.
`netapp_root_volume_name`	Optional	`root`	This option specifies name of the root volume that will be created when a new SVM is created to correspond to a Manila share server.
`netapp_vserver_name_template`	Optional	`os_%s`	This option specifies a string replacement template that is applied when naming SVMs that are created to correspond to a Manila share server.
`netapp_lif_name_template`	Optional	`os_%(net_allocation_id)s`	This option specifies a string replacement template that is applied when naming data LIFs that are created as a result of provisioning requests.
`netapp_volume_name_template`	Optional	`share_%(share_id)s`	This option specifies a string replacement template that is applied when naming FlexVol volumes that are created as a result of provisioning requests.
`netapp_volume_snapshot_reserve_percent`	Optional	`5`	This option specifies the percentage of share space set aside as reserve for snapshot usage. Valid values range from 0 to 90.
`netapp_aggregate_name_search_pattern`	Optional	`(.*)`	This option specifies a regular expression that is applied against all available aggregates. This filtered list will be reported to the Manila scheduler as valid pools for provisioning new shares.
`netapp_port_name_search_pattern`	Optional	`(.*)`	This option allows you to specify a regular expression for overriding the selection of network ports on which to create Vserver LIFs.
`netapp_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 Manila logs when the debug level is set to `True`.

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 Manila logs. See the section called “Account Permission Considerations” for more details on the required access level permissions for an SVM admin account.

	Caution
	When defining Neutron subnets (Liberty or prior) with Clustered Data ONTAP, overlapping IP ranges should not be allowed. Using overlapping IP ranges in Neutron can cause a failure when a new Share Server is created.

Legal notices