RETIRED, Fuel plugin for ScaleIO storage backend integration
Go to file
Adrian Moreno 4513991cca Merge branch 'master' into stable/1.0
* master:
  Fixed provisioning type key. All volumes should be created with thin provisioning
  Fixed blank pages in plugin guide
  Updated successful deployment figure with new message
  Updated plugin guide title
  Updated plugin guide according to validation report
  Update plugin guide with validation remarks
  Updated test plan and test report with validation observations
  Updated version in plugin guide
  Updated plugin description to avoid confusion after deployment has finished.

Change-Id: I2ed33df717f3ebc8b4cf87079baf29203600df6a
2015-12-10 11:54:18 +01:00
deployment_scripts/puppet Fixed provisioning type key. All volumes should be created with thin provisioning 2015-12-09 18:15:43 +01:00
doc Fixed blank pages in plugin guide 2015-12-09 16:15:12 +01:00
repositories Updated Java from 1.7 to 1.8 2015-11-17 15:21:18 -08:00
spec Fixed plugin specs styling 2015-11-26 16:47:22 +01:00
.gitignore Updated gitignore 2015-12-02 15:03:55 +01:00
.gitmodules added ScaleIO and Java Puppet modules as Git submodules 2015-10-22 11:07:47 +02:00
.gitreview Added .gitreview 2015-09-14 16:05:07 +00:00
CONTRIBUTING.md Updated README 2015-11-19 11:26:40 -08:00
LICENSE Updated README file to inform about the Launchpad site 2015-11-18 17:25:02 -08:00
README.md Updated README with new plugin version 2015-12-01 13:16:58 +01:00
Vagrantfile updated Vagrantfile and ScaleIO drivers for Cinder 2015-11-06 10:06:25 +01:00
environment_config.yaml Code refactoring. Simplified plugin configuration from UI. 2015-11-26 14:51:31 +01:00
metadata.yaml Updated plugin description to avoid confusion after deployment has finished. 2015-12-04 11:59:07 +01:00
pre_build_hook Initial version 2015-10-15 17:39:11 +02:00
tasks.yaml Renamed manifests and tasks 2015-11-25 17:34:58 +01:00

README.md

ScaleIO Plugin for Fuel

Overview

The ScaleIO plugin deploys an EMC ScaleIO cluster on the available nodes and replaces the default OpenStack volume backend by ScaleIO.

If you want to leverage an existing ScaleIO cluster and deploy an OpenStack cluster to use that ScaleIO cluster, please take a look at the ScaleIO Cinder plugin.

## Requirements

Requirement Version/Comment
Mirantis OpenStack compatibility 6.1

## Recommendations

None.

Limitations

Due to some software limitations, this plugin is currently only compatible with Mirantis 6.1 and CentOS.

Installation Guide

ScaleIO Plugin install from RPM file

To install the ScaleIO plugin, follow these steps:

  1. Download the plugin from the Fuel Plugins Catalog.

  2. Copy the plugin file to the Fuel Master node. Follow the Quick start guide if you don't have a running Fuel Master node yet.

    $ scp scaleio-1.0-1.0.0-1.noarch.rpm root@<Fuel Master node IP address>:/tmp/
    
  3. Log into the Fuel Master node and install the plugin using the fuel command line.

    $ fuel plugins --install /tmp/scaleio-1.0-1.0.0-1.noarch.rpm
    
  4. Verify that the plugin is installed correctly.

    $ fuel plugins
    

ScaleIO Plugin install from source code

To install the ScaleIO Plugin from source code, you first need to prepare an environment to build the RPM file of the plugin. The recommended approach is to build the RPM file directly onto the Fuel Master node so that you won't have to copy that file later.

Prepare an environment for building the plugin on the Fuel Master node.

  1. Install the standard Linux development tools:

    $ yum install createrepo rpm rpm-build dpkg-devel
    
  2. Install the Fuel Plugin Builder. To do that, you should first get pip:

    $ easy_install pip
    
  3. Then install the Fuel Plugin Builder (the fpb command line) with pip:

    $ pip install fuel-plugin-builder
    

Note: You may also have to build the Fuel Plugin Builder if the package version of the plugin is higher than package version supported by the Fuel Plugin Builder you get from pypi. In this case, please refer to the section "Preparing an environment for plugin development" of the Fuel Plugins wiki if you need further instructions about how to build the Fuel Plugin Builder.

  1. Clone the ScaleIO Plugin git repository (note the --recursive option):

    $ git clone --recursive git@github.com:openstack/fuel-plugin-scaleio.git
    
  2. Check that the plugin is valid:

    $ fpb --check ./fuel-plugin-scaleio
    
  3. Build the plugin:

    $ fpb --build ./fuel-plugin-scaleio
    
  4. Now you have created an RPM file that you can install using the steps described above. The RPM file will be located in:

    $ ./fuel-plugin-scaleio/scaleio-1.0-1.0.0-1.noarch.rpm
    

User Guide

Please read the ScaleIO Plugin User Guide.

Contributions

Please read the CONTRIBUTING.md document for the latest information about contributions.

Bugs, requests, questions

Please use the Launchpad project site to report bugs, request features, ask questions, etc.

License

Please read the LICENSE document for the latest licensing information.