NetApp Clustered Data ONTAP driver

The Shared File Systems service can be configured to use NetApp clustered Data ONTAP version 8.

Network approach

L3 connectivity between the storage cluster and Shared File Systems service host should exist, and VLAN segmentation should be configured.

The clustered Data ONTAP driver creates storage virtual machines (SVM, previously known as vServers) as representations of the Shared File Systems service share server interface, configures logical interfaces (LIFs) and stores shares there.

Supported shared filesystems and operations

The driver supports CIFS and NFS shares.

The following operations are supported:

  • Create a share.

  • Delete a share.

  • Allow share access.

    Note the following limitations:

    • Only IP access type is supported for NFS.

    • Only user access type is supported for CIFS.

  • Deny share access.

  • Create a snapshot.

  • Delete a snapshot.

  • Create a share from a snapshot.

  • Extend a share.

  • Shrink a share.

  • Create a consistency group.

  • Delete a consistency group.

  • Create a consistency group snapshot.

  • Delete a consistency group snapshot.

Required licenses

  • NFS

  • CIFS

  • FlexClone

Known restrictions

  • For CIFS shares an external active directory service is required. Its data should be provided via security-service that is attached to used share-network.

  • Share access rule by user for CIFS shares can be created only for existing user in active directory.

  • To be able to configure clients to security services, the time on these external security services and storage should be synchronized. The maximum allowed clock skew is 5 minutes.

Driver options

The following table contains the configuration options specific to the share driver.

Description of NetApp share driver configuration options

Configuration option = Default value

Description

[DEFAULT]

netapp_aggregate_name_search_pattern = (.*)

(String) Pattern for searching available aggregates for provisioning.

netapp_enabled_share_protocols = nfs3, nfs4.0

(List) The NFS protocol versions that will be enabled. Supported values include nfs3, nfs4.0, nfs4.1. This option only applies when the option driver_handles_share_servers is set to True.

netapp_lif_name_template = os_%(net_allocation_id)s

(String) Logical interface (LIF) name template

netapp_login = None

(String) Administrative user account name used to access the storage system.

netapp_password = None

(String) Password for the administrative user account specified in the netapp_login option.

netapp_port_name_search_pattern = (.*)

(String) Pattern for overriding the selection of network ports on which to create Vserver LIFs.

netapp_root_volume = root

(String) Root volume name.

netapp_root_volume_aggregate = None

(String) Name of aggregate to create Vserver root volumes on. This option only applies when the option driver_handles_share_servers is set to True.

netapp_server_hostname = None

(String) The hostname (or IP address) for the storage system.

netapp_server_port = None

(Port number) 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_snapmirror_quiesce_timeout = 3600

(Integer) The maximum time in seconds to wait for existing snapmirror transfers to complete before aborting when promoting a replica.

netapp_storage_family = ontap_cluster

(String) The storage family type used on the storage system; valid values include ontap_cluster for using clustered Data ONTAP.

netapp_trace_flags = None

(String) Comma-separated list of options that control which trace info is written to the debug logs. Values include method and api.

netapp_transport_type = http

(String) The transport protocol used when communicating with the storage system or proxy server. Valid values are http or https.

netapp_volume_move_cutover_timeout = 3600

(Integer) The maximum time in seconds to wait for the completion of a volume move operation after the cutover was triggered.

netapp_volume_name_template = share_%(share_id)s

(String) NetApp volume name template.

netapp_volume_snapshot_reserve_percent = 5

(Integer) The percentage of share space set aside as reserve for snapshot usage; valid values range from 0 to 90.

netapp_vserver_name_template = os_%s

(String) Name template to use for new Vserver. When using CIFS protocol make sure to not configure characters illegal in DNS hostnames.