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

3.5 KiB

Guide to the SolidFire Cinder Plugin version 1.0.0 for Fuel

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

Key terms, acronyms and abbreviations

MVIP

Management Virtual IP (MVIP) is the IP address (or hostname) of the management interface to the SolidFire cluster

Cluster Admin account

The Cluster Admin account on a SolidFire cluster is the account by which you administer the SolidFire cluster.

SolidFire accounts

SolidFire accounts are automatically created by the SolidFire OpenStack driver as needed based on the Project ID. These accounts manage the CHAP authentication for the volumes allocated by that project. No configuration is needed for these accounts.

SolidFire Cinder =============

The SolidFire Cinder Fuel plugin provides an automated method to insert the necessary lines into the cinder.conf file. The plugin extends the Fuel GUI to provide the necessary entry locations for the information for the configuration file.

License

Component License type

No Components are present

Requirements

Requirement Version/Comment

Fuel

6.1

Limitations

Fuel does not support multiple storage backends in Cinder, therefore the SolidFire Cinder Fuel plugin also does not support multiple backends. The SolidFire Cinder Fuel plugin does however provide the ability to create a configuarion file stanza such that when multi-backend support is added to fuel the stanza is correct.

Installation Guide

Provide step-by-step instructions for plugin installation. If plugin requires pre-installation steps like backend configuration, you should also add this information here.

SolidFire Cinder Plugin installation --------------------------

  1. Download the plugin from Fuel Plugins Catalog.
  2. Copy the plugin on already installed Fuel Master node. If you do not have the Fuel Master node yet, see Quick Start Guide: scp fuel-plugin-solidfire-cinder-1.0-1.0.1-1.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 /tmp/fuel-plugin-solidfire-cinder-1.0-1.0.1-1.noarch.rpm

  5. After plugin is installed, create a new OpenStack environment.
  6. Configure your environment.
  7. Open the Settings tab of the Fuel web UI and scroll down the page. Select the Fuel plugin to enable SolidFire driver in Cinder plugin checkbox:
7. Enter the Cluster Admin account information (account and password) and the IP address

of the Management Virtual IP (MVIP) of the SolidFire Cluster.

7a. Select the defaults for all other SolidFire options.

User Guide

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

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

Known issues

There are no known issues at this time.

Appendix

N/A