fuel-plugin-purestorage-cinder/docs/purestorage-cinder-guide.rst

4.2 KiB

Guide to the Pure Storage Cinder Plugin version 1.0-1.0.0-1 for Fuel

This document provides instructions for installing, configuring and using Pure Storage Cinder plugin for Fuel.

Pure Storage Cinder

The Pure Storage Cinder Fuel plugin provides an automated method to insert the necessary lines into the cinder.conf file. The plugin extends the Fuel Web UI to provide the necessary entry locations for the information for the configuration file. Thus, the plugin incorporates OpenStack Cinder Driver for Pure Storage Flash Array. Thus, the plugin provides the ability to create a configuration file stanza so that when multi-backend support is selected, the stanza is correct.

License

Component License type

No Components are present

Requirements

Requirement Version/Comment

Fuel

7.0

Limitations

No limitations are present

Installation Guide

Make sure your Pure Storage Flash Array is up and running. For more information on the Array configuration, follow the official documentation available on the Pure Storage Community Website.

Pure Storage Cinder Plugin installation --------------------------

  1. Download the plugin from the Fuel Plugins Catalog.

  2. Copy the plugin to an already installed Fuel Master node. If you do not have the Fuel Master node yet, please follow the instructions:

    scp  fuel-plugin-purestorage-cinder-1.0-1.0.0.noarch.rpm root@:<the_Fuel_Master_node_IP>:/tmp
  3. Log into the Fuel Master node.

  4. Install the plugin

    cd /tmp
    fuel plugins --install fuel-plugin-purestorage-cinder-1.0-1.0.0.noarch.rpm
  5. Check if the plugin was installed successfully

    # fuel plugins
    id | name                           | version | package_version
    ---|--------------------------------|---------|----------------
     1 | fuel-plugin-purestorage-cinder | 1.0.0   | 2.0.0
  6. After the plugin is installed, create a new OpenStack environment using the Fuel UI Wizard.

  7. Configure your environment.

  8. Open the Settings tab of the Fuel Web UI and scroll down the page. Select the Fuel plugin to enable Pure Storage driver in Cinder plugin checkbox.

    image

  9. Enter the Purity API Token and the IP address of the management VIP of the Pure Storage FlashArray.

  10. Select the defaults for all other Pure Storage options.

User Guide

Once the OpenStack instance is deployed by Fuel the Pure Storage plugin provides no user configurable or maintainable options.

The Pure Storage driver (Once configured by Fuel) will output all logs into the cinder-volume process log file with the 'Pure Storage' title.

Known issues

There are no known issues at this time.

Appendix

  1. OpenStack Cinder Driver for Pure Storage Flash Array
  2. Pure Storage Flash Array User Guide