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.
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 theenabled_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