manila/doc/source/configuration/shared-file-systems/drivers/dell-emc-powerflex-driver.rst

Dell EMC PowerFlex driver

The Dell EMC Shared File Systems service driver framework (EMCShareDriver) utilizes the Dell EMC storage products to provide the shared file systems to OpenStack. The Dell EMC driver is a plug-in based driver which is designed to use different plug-ins to manage different Dell EMC storage products.

The PowerFlex SDNAS plug-in manages the PowerFlex system to provide shared filesystems. The Dell EMC driver framework with the PowerFlex SDNAS plug-in is referred to as the PowerFlex SDNAS driver in this document.

The PowerFlex SDNAS driver can be used to provide functions such as share and snapshot for instances.

The PowerFlex SDNAS driver enables the PowerFlex 4.x storage system to provide file system management through REST API operations to OpenStack.

Requirements

• PowerFlex 4.x storage system
• SDNAS cluster registrated with SDNAS Gateway.

Supported shared filesystems and operations

The driver suppors NFS shares only.

The following operations are supported:

• Create a share.
• Delete a share.
• Allow share access.
• Deny share access.
• Extend a share.
• Create a snapshot.
• Delete a snapshot.

Driver configuration

Edit the manila.conf file, which is usually located under the following path /etc/manila/manila.conf.

• Add a section for the PowerFlex SDNAS driver backend.

• Under the [DEFAULT] section, set the enabled_share_backends parameter with the name of the new backend section.

• Configure the driver backend section with the parameters below.

  share_driver = manila.share.drivers.dell_emc.driver.EMCShareDriver
  emc_share_backend = powerflex
  dell_nas_backend_host = <Management IP of the PowerFlex system>
  dell_nas_backend_port = <Port number used for secured connection>
  dell_nas_server = <Name of the NAS server within the PowerFlex system>
  dell_nas_login = <user with administrator privilege>
  dell_nas_password = <password>
  powerflex_storage_pool = <Name of the storage pool>
  powerflex_protection_domain = <Name of the protection domain>
  share_backend_name = powerflex
  dell_ssl_cert_verify = <True|False>
  dell_ssl_certificate_path = <Path to SSL certificates>

  Where:

  Parameter	Description
  share_driver	Full path of the EMCShareDriver used to enable the plugin.
  emc_share_backend	The plugin name. Set it to powerflex to enable the PowerFlex SDNAS driver.
  dell_nas_backend_host	The management IP of the PowerFlex system.
  dell_nas_backend_port	The port number used for secured connection. 443 by default if not provided.
  dell_nas_server	The name of the NAS server within the PowerFlex system.
  dell_nas_login	The login to use to connect to the PowerFlex system. It must have administrator privileges.
  dell_nas_password	The password associated with the login.
  powerflex_storage_pool	The name of the storage pool within the PowerFlex system.
  powerflex_protection_domain	The name of the protection domain within the PowerFlex system.
  share_backend_name	The name of the backend which provides shares. Must be set to powerflex
  dell_ssl_cert_verify	Boolean to enable the usage of SSL certificates. False is the default value.
  dell_ssl_certificate_path	Full path to SSL certificates. Applies only when the usage of SSL certificate is enabled.

Restart of manila-share service is needed for the configuration changes to take effect.

Required operations prior to any usage

A new share type needs to be created before going further.

$ openstack share type create powerflex False

Map this share type to the backend section configured in Manila

$ openstack share type set --extra_specs share_backend_name=powerflex powerflex

Specific configuration for Snapshot support

The following extra specifications need to be configured with share type.

• snapshot_support = True

For new share type, these extra specifications can be set directly when creating share type:

$ openstack share type create --extra_specs snapshot_support=True powerflex False

Or you can update already existing share type with command:

$ openstack share type set --extra_specs snapshot_support=True powerflex

Known restrictions

The PowerFlex SDNAS driver has the following restrictions.

• Minimum size 3GiB.
• Only NFS protocol is supported.
• Only DHSS=False is supported