kolla-ansible/doc/source/reference/storage/manila-pure-guide.rst

Pure Storage FlashBlade File Services Driver for OpenStack

Overview

The Pure Storage FlashBlade File Services Driver for OpenStack provides NFS Shared File Systems to OpenStack.

Requirements

• Pure Storage FlashBlade
• Purity//FB v2.3.0 or higher

Supported shared file systems and operations

The driver supports NFS shares.

The following operations are supported:

• Create a share.
• Delete a share.
• Allow share access.
• Deny share access.
• Create a snapshot.
• Delete a snapshot.
• Revert from snapshot.
• Extend a share.
• Shrink a share.

Preparation and Deployment

It is mandatory that FlashBlade management interface is reachable from the Shared File System node through the admin network, while the selected EVS data interface is reachable from OpenStack Cloud, such as through Neutron flat networking.

Configuration on Kolla deployment

Enable Shared File Systems service and FlashBlade driver in /etc/kolla/globals.yml

enable_manila: "yes"
enable_manila_backend_flashblade: "yes"

Configure the OpenStack networking so it can reach FlashBlade Management interface and FlashBlade Data interface.

To configure two physical networks, physnet1 and physnet2, with ports eth1 and eth2 associated respectively:

In /etc/kolla/globals.yml set:

neutron_bridge_name: "br-ex,br-ex2"
neutron_external_interface: "eth1,eth2"

Note

eth1 is used to Neutron external interface and eth2 is used to FlashBlade data interface.

FlashBlade back end configuration

In /etc/kolla/globals.yml uncomment and set:

manila_flashblade_mgmt_vip: "172.24.44.15"
manila_flashblade_data_vip: "172.24.45.22"
manila_flashblade_api: "<API token for admin-privilaged user>"

Configuration on FlashBlade

Create the FlashBlade data network in Kolla OpenStack:

List the available tenants:

$ openstack project list

Create a network to the given tenant (service), providing the tenant ID, a name for the network, the name of the physical network over which the virtual network is implemented, and the type of the physical mechanism by which the virtual network is implemented:

$ openstack network create --project <SERVICE_ID> \
  --provider-physical-network physnet2 \
  --provider-network-type flat \
  flashblade_network

Optional - List available networks:

$ openstack network list

Create a subnet to the same tenant (service), the gateway IP of this subnet, a name for the subnet, the network ID created before, and the CIDR of subnet:

$ openstack subnet create --project <SERVICE_ID>  --gateway <GATEWAY> \
  --subnet_range <SUBNET_CIDR> flashblade_subnet

Optional - List available subnets:

$ openstack subnet list

Add the subnet interface to a router, providing the router ID and subnet ID created before:

$ openstack router add submet <ROUTER_ID> <SUBNET_ID>

Create a share

Create a default share type before running manila-share service:

$ openstack share type create default_share_flashblade False

+--------------------------------------+--------------------------+------------+------------+--------------------------------------+-------------------------+
| ID                                   | Name                     | visibility | is_default | required_extra_specs                 | optional_extra_specs    |
+--------------------------------------+--------------------------+------------+------------+--------------------------------------+-------------------------+
| 3e54c8a2-1e50-455e-89a0-96bb52876c35 | default_share_flashblade | public     | -          | driver_handles_share_servers : False | snapshot_support : True |
+--------------------------------------+--------------------------+------------+------------+--------------------------------------+-------------------------+

Create a NFS share using the FlashBlade back end:

$ openstack share create --name <myflashbladeshare \
  --description "My Manila share" \
  --share-type default_share_flashblade \
  NFS 1

Verify Operation:

$ openstack share list

+--------------------------------------+-------------------+------+-------------+-----------+-----------+--------------------------+-----------------+-------------------+
| ID                                   | Name              | Size | Share Proto | Status    | Is Public | Share Type Name          | Host            | Availability Zone |
+--------------------------------------+-------------------+------+-------------+-----------+-----------+--------------------------+-----------------+-------------------+
| 721c0a6d-eea6-41af-8c10-72cd98985203 | myflashbladeshare | 1    | NFS         | available | False     | default_share_flashblade | control@fb1#FB1 | nova              |
+--------------------------------------+-------------------+------+-------------+-----------+-----------+--------------------------+-----------------+-------------------+

$ openstack share show myflashbladeshare

+-----------------------------+-----------------------------------------------------------------+
| Property                    | Value                                                           |
+-----------------------------+-----------------------------------------------------------------+
| status                      | available                                                       |
| share_type_name             | default_share_flashblade                                        |
| description                 | My Manila share                                                 |
| availability_zone           | nova                                                            |
| share_network_id            | None                                                            |
| export_locations            |                                                                 |
|                             | path = 172.24.53.1:/shares/45ed6670-688b-4cf0-bfe7-34956648fb84 |
|                             | preferred = False                                               |
|                             | is_admin_only = False                                           |
|                             | id = e81e716f-f1bd-47b2-8a56-2c2f9e33a98e                       |
|                             | share_instance_id = 45ed6670-688b-4cf0-bfe7-34956648fb84        |
| share_server_id             | None                                                            |
| host                        | control@fb1#FB1                                                 |
| access_rules_status         | active                                                          |
| snapshot_id                 | None                                                            |
| is_public                   | False                                                           |
| task_state                  | None                                                            |
| snapshot_support            | True                                                            |
| id                          | 721c0a6d-eea6-41af-8c10-72cd98985203                            |
| size                        | 1                                                               |
| user_id                     | ba7f6d543713488786b4b8cb093e7873                                |
| name                        | myflashbladeshare                                               |
| share_type                  | 3e54c8a2-1e50-455e-89a0-96bb52876c35                            |
| has_replicas                | False                                                           |
| replication_type            | None                                                            |
| created_at                  | 2016-10-14T14:50:47.000000                                      |
| share_proto                 | NFS                                                             |
| consistency_group_id        | None                                                            |
| source_cgsnapshot_member_id | None                                                            |
| project_id                  | c3810d8bcc3346d0bdc8100b09abbbf1                                |
| metadata                    | {}                                                              |
+-----------------------------+-----------------------------------------------------------------+

Configure multiple back ends

An administrator can configure an instance of Manila to provision shares from one or more back ends. Each back end leverages an instance of a vendor-specific implementation of the Manila driver API.

The name of the back end is declared as a configuration option share_backend_name within a particular configuration stanza that contains the related configuration options for that back end.

So, in the case of an multiple back ends deployment, it is necessary to change the default share backends before deployment.

Modify the file /etc/kolla/config/manila.conf and add the contents:

[DEFAULT]
enabled_share_backends = generic,fb1,fb2

Modify the file /etc/kolla/config/manila-share.conf and add the contents:

[generic]
share_driver = manila.share.drivers.generic.GenericShareDriver
interface_driver = manila.network.linux.interface.OVSInterfaceDriver
driver_handles_share_servers = True
service_instance_password = manila
service_instance_user = manila
service_image_name = manila-service-image
share_backend_name = GENERIC

[fb1]
share_backend_name = FB1
share_driver = manila.share.drivers.purestorage.flashblade.FlashBladeShareDriver
driver_handles_share_servers = False
flashblade_mgmt_vip = <fb1_mgmt_ip>
flashblade_data_vip = <fb1_data_ip>
flashblade_api = <FB1 API token>

[fb2]
share_backend_name = FB2
share_driver = manila.share.drivers.purestorage.flashblade.FlashBladeShareDriver
driver_handles_share_servers = False
flashblade_mgmt_vip = <fb2_mgmt_ip>
flashblade_data_vip = <fb2_data_ip>
flashblade_api = <FB2 API token>

For more information about how to manage shares, see the Manage shares <user/create-and-manage-shares.html>.

For details on how to use the Pure Storage FlashBlade, refer to the Pure Storage Manila Reference Guide.

The use of this backend requires that the purity_fb SDK package is installed in the manila-share container. To do this follow the steps outlined in the kolla image building guide particularly the Package Customisation and Custom Repos sections.