fixing format round2

Change-Id: I49c61ee8f17c61c8547c467a8d9717cd49c7aa5a
This commit is contained in:
msalem2 2015-10-28 09:56:48 +09:00
parent 5a8c0713e1
commit d1e52c9e7a
1 changed files with 59 additions and 84 deletions

View File

@ -1,105 +1,80 @@
====================================
Install ScaleIO Cinder Plugin
====================================
To install the MidoNet Fuel plugin:
#. Download it from the `Fuel Plugins Catalog`_
#. Copy the *rpm* file to the Fuel Master node:
::
[root@home ~]# scp scaleio-cinder-1.0-1.0.0-1.noarch.rpm root@fuel:/tmp
#. Log into Fuel Master node and install the plugin using the
`Fuel CLI <https://docs.mirantis.com/openstack/fuel/fuel-6.1/user-guide.html#using-fuel-cli>`_:
::
[root@fuel ~]# fuel plugins --install scaleio-cinder-1.0-1.0.0-1.noarch.rpm
#. Verify that the plugin is installed correctly:
::
[root@fuel-master ~]# fuel plugins
id | name | version | package_version
---|---------|---------|----------------
1 | scaleio-cinder | 1.0.0 | 1.0.0
===========================================================
ScaleIO Cinder plugin installation
ScaleIO Cinder plugin configuration
===========================================================
The first step is to install the ScaleIO Cinder plugin in the Fuel Master:
Once the plugin has been installed in the Master, we configure the nodes and set the parameters for the plugin:
1. Download the plugin from the
https://github.com/openstack/fuel-plugin-scaleio-cinder/releases
"Releases Page" or from the
https://www.mirantis.com/products/openstack-drivers-and-plugins/fuel-plugins/
"Fuel Plugins Catalog".
2. Copy the plugin to an already installed Fuel Master node. If you do
not have the Fuel Master node yet, follow the instructions from the
official Mirantis OpenStack documentation:
1. Start by creating a new OpenStack environment following the https://docs.mirantis.com/openstack/fuel/fuel-6.1/user-guide.html#create-a-new-openstack-environment "Creating a new OpenStack environment")
``scp fuel-plugin-scaleio-cinder-1.0.noarch.rpm root@:<the_Fuel_Master_node_IP>:/tmp``
3. Log into the Fuel Master node and install the plugin, if downloaded
in the ``/tmp`` directory:
``cd /tmp``
``fuel plugins --install /tmp/fuel-plugin-scaleio-cinder-1.0.noarch.rpm``
4. Verify that the plugin has been installed successfully:
.. image:: https://github.com/openstack/fuel-plugin-scaleio-cinder/blob/master/doc/images/scaleio-cinder-install-1.png
=========================================================== ScaleIO
Cinder plugin configuration
=========================================================== Once the
plugin has been installed in the Master, we configure the nodes and set
the parameters for the plugin:
1. Start by creating a new OpenStack environment following the
https://docs.mirantis.com/openstack/fuel/fuel-6.1/user-guide.html#create-a-new-openstack-environment
"Creating a new OpenStack environment")
2. Configure your environment following the
https://docs.mirantis.com/openstack/fuel/fuel-6.1/user-guide.html#configure-your-environment
2. Configure your environment following the https://docs.mirantis.com/openstack/fuel/fuel-6.1/user-guide.html#configure-your-environment
.. image:: https://github.com/openstack/fuel-plugin-scaleio-cinder/blob/master/doc/images/scaleio-cinder-install-2.png
3. Open the **Settings tab** of the Fuel web UI and scroll down the
page. Select the Fuel plugin check-box to enable ScaleIO Cinder
plugin for Fuel:
3. Open the **Settings tab** of the Fuel web UI and scroll down the page. Select the Fuel plugin check-box to enable ScaleIO Cinder plugin for Fuel:
.. image:: https://github.com/openstack/fuel-plugin-scaleio-cinder/blob/master/doc/images/scaleio-cinder-install-4.PNG
**Plugin's parameters explanation:**
+-------------------------+---------------------------------------------------------+
\|Parameter Name \|Parameter Description \|
|Parameter Name |Parameter Description |
+=========================+=========================================================+
\|userName \|The ScaleIO User Name \|
|userName |The ScaleIO User Name |
+-------------------------+---------------------------------------------------------+
\|Password \|The SclaeIO password for the selected user name \|
|Password |The SclaeIO password for the selected user name |
+-------------------------+---------------------------------------------------------+
\|ScaleIO GW IP \|The IP address of the the ScaleIO Gateway service
\|
|ScaleIO GW IP |The IP address of the the ScaleIO Gateway service |
+-------------------------+---------------------------------------------------------+
\|ScaleIO Primary IP \|The ScaleIO cluster's primary IP address \|
|ScaleIO Primary IP |The ScaleIO cluster's primary IP address |
+-------------------------+---------------------------------------------------------+
\|ScaleIO Secondary IP \|The ScaleIO cluster's secondary IP address
\|
|ScaleIO Secondary IP |The ScaleIO cluster's secondary IP address |
+-------------------------+---------------------------------------------------------+
\|ScaleIO protection domain\|Name of the ScaleIO's protection domain
\|
|ScaleIO protection domain|Name of the ScaleIO's protection domain |
+-------------------------+---------------------------------------------------------+
\|ScaleIO storage pool 1 \|Name of the first storage pool \|
|ScaleIO storage pool 1 |Name of the first storage pool |
+-------------------------+---------------------------------------------------------+
**Note:** Please refer to the ScaleIO documentation for more
information on these parameters
**Note:** Please refer to the ScaleIO documentation for more information on these parameters
This is an example of the ScaleIO configuration paremets populated:
.. image:: https://github.com/openstack/fuel-plugin-scaleio-cinder/blob/master/doc/images/scaleio-cinder-install-5.PNG
4. | After the configuration is done, you can Add the nodes to the
Openstack Deployment. There is a minimum of two nodes for this
configuration:
+-------------------------+----------------------------------------------------------------------------------------------+
\|Service/Role Name \| Description \|
+=========================+==============================================================================================+
\|Controller Node \|A node that runs network, volume, API,
scheduler, and image services. Each service may be \| \|+ Cinder
Host \|broken out into separate nodes for scalability or
availability. \| \| \|In addition this node is a Cinder Host, that
contains the Cinder Volume Manager \|
+-------------------------+----------------------------------------------------------------------------------------------+
| \|Compute Node \|A node that runs the nova-compute daemon that
manages Virtual Machines (VMs) instances that \| \| \|provide a
wide range of services, such as web applications and analytics. \|
+-------------------------+----------------------------------------------------------------------------------------------+
| .. image:: https://github.com/openstack/fuel-plugin-scaleio-cinder/blob/master/doc/images/scaleio-cinder-install-3.PNG
4. After the configuration is done, you can Add the nodes to the Openstack Deployment.
.. image:: https://github.com/openstack/fuel-plugin-scaleio-cinder/blob/master/doc/images/scaleio-cinder-install-3.PNG
**Note:** you can run the
.. image:: https://docs.mirantis.com/openstack/fuel/fuel-6.1/user-guide.html#verify-networks
check and
https://docs.mirantis.com/openstack/fuel/fuel-6.1/user-guide.html#deploy-changes.
check and https://docs.mirantis.com/openstack/fuel/fuel-6.1/user-guide.html#deploy-changes.
After this is complete you should see a success message:
.. image:: https://github.com/openstack/fuel-plugin-scaleio-cinder/blob/master/doc/images/scaleio-cinder-install-complete.jpg
**Note:** It make take an hour or more for the OpenStack deployment
to complete, depending on your hardware configuration.
**Note:** It make take an hour or more for the OpenStack deployment to complete, depending on your hardware configuration.