RETIRED, Fuel plugin for Cinder with EMC integration
Go to file
OpenDev Sysadmins c45a9999f4 OpenDev Migration Patch
This commit was bulk generated and pushed by the OpenDev sysadmins
as a part of the Git hosting and code review systems migration
detailed in these mailing list posts:

http://lists.openstack.org/pipermail/openstack-discuss/2019-March/003603.html
http://lists.openstack.org/pipermail/openstack-discuss/2019-April/004920.html

Attempts have been made to correct repository namespaces and
hostnames based on simple pattern matching, but it's possible some
were updated incorrectly or missed entirely. Please reach out to us
via the contact information listed at https://opendev.org/ with any
questions you may have.
2019-04-19 19:50:48 +00:00
deployment_scripts/puppet disable destroy_empty_storage_group parameter due to race codition 2015-04-29 11:18:26 +02:00
doc documentation update: add limitation about emc plugin and cinder role 2015-09-16 12:25:22 +02:00
repositories add EMC VNX plugin code 2015-04-23 21:45:57 +02:00
specs fix MOS version in Dependencies section in the spec file 2015-04-28 16:18:14 +02:00
.gitignore change compatible MOS version and OS releases in the metadata.yaml 2015-08-07 13:42:16 +02:00
.gitreview OpenDev Migration Patch 2019-04-19 19:50:48 +00:00
LICENSE add EMC VNX plugin code 2015-04-23 21:45:57 +02:00
README.md fix links 2015-10-21 14:20:36 +02:00
environment_config.yaml add EMC VNX plugin code 2015-04-23 21:45:57 +02:00
metadata.yaml change compatible MOS version and OS releases in the metadata.yaml 2015-08-07 13:42:16 +02:00
pre_build_hook Updated links to dependent packages 2016-06-08 17:45:21 +03:00
tasks.yaml add EMC VNX plugin code 2015-04-23 21:45:57 +02:00

README.md

EMC VNX Plugin for Fuel

EMC VNX plugin

EMC VNX plugin for Fuel extends Mirantis OpenStack functionality by adding support for EMC VNX arrays in Cinder using iSCSI protocol. It replaces Cinder LVM driver which is the default volume backend that uses local volumes managed by LVM.

Requirements

Requirement Version/Comment
Mirantis OpenStack compatibility >= 7.0

Limitations

Since only one storage network is available in Fuel 6.x on OpenStack nodes, multipath will bind all storage paths from EMC on one network interface. In case this NIC fails, the communication with storage is lost.

Installation Guide

EMC VNX configuration

Before starting a deployment you have to preconfigure EMC VNX array and connect it properly to the environment. Both EMC SP IPs and all iSCSI ports should be available over storage interface from OpenStack nodes. To learn more about EMC VNX configuration, see the official EMC VNX series documentation

EMC VNX configuration checklist:

  1. create username/password
  2. create at least one storage pool
  3. configure network for A and B Service Processors
  4. configure network for all iSCSI ports

EMC VNX plugin installation

To install EMC VNX plugin, follow these steps:

  1. Download the plugin from Fuel Plugins Catalog

  2. Copy the plugin on already installed Fuel Master node; ssh can be used for that. If you do not have the Fuel Master node yet, see Quick Start Guide:

     # scp emc_vnx-2.0-2.0.0-0.noarch.rpm root@<Fuel_master_ip>:/tmp
    
  3. Log into the Fuel Master node. Install the plugin:

     # cd /tmp
     # fuel plugins --install emc_vnx-2.0-2.0.0-0.noarch.rpm
    
  4. Check if the plugin was installed successfully:

     # fuel plugins
     id | name    | version | package_version
     ---|---------|---------|----------------
     1  | emc_vnx | 2.0.0   | 2.0.0
    

EMC VNX plugin configuration

  1. Create an environment with the default backend for Cinder.
  2. Enable the plugin on the Settings tab of the Fuel web UI and fill in form fields:
    • username/password - access credentials configured on EMC VNX
    • SP A/B IP - IP addresses of the EMC VNX Service Processors
    • pool name (optional) - a name of the EMC VNX storage pool on which all Cinder volumes will be created. Provided storage pool must be available on EMC VNX. If pool name is not provided then EMC VNX driver will use a random storage pool available on EMC VNX. You can also use a Volume Type OpenStack feature to create a volume on a specific storage pool. For more information, see Multiple pools support
  3. Deploy the environment without a Cinder node. All required Cinder services are run on Controller nodes.

Release Notes

This is the first release of the plugin.

Build Instructions

Instructions how build a plugin from source are available on: How To: Build and install a plugin from source

Contributors

Dmitry Klenov dklenov@mirantis.com (PM) Szymon Bańka sbanka@mirantis.com (developer) Piotr Misiak pmisiak@mirantis.com (developer) Dmitry Kalashnik dkalashnik@mirantis.com (QA engineer) Maciej Relewicz mrelewicz@mirantis.com (developer)