fuel-plugin-scaleio-cinder/doc/content/installation.rst

89 lines
3.9 KiB
ReStructuredText

Install ScaleIO Cinder Plugin
=============================
To install the ScaleIO-Cinder Fuel plugin:
#. Download it from the
`Fuel Plugins Catalog <https://www.mirantis.com/products/openstack-drivers-and-plugins/fuel-plugins/>`_.
#. 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
.. raw:: pdf
PageBreak
Configure ScaleIO plugin
------------------------
Once the plugin has been copied and installed at the
Fuel Master node, you can configure the nodes and set the parameters for the plugin:
#. Start by creating a new OpenStack environment following the
`Mirantis OpenStack User Guide <https://docs.mirantis.com/openstack/fuel/fuel-6.1/user-guide.html#create-a-new-openstack-environment>`_.
#. `Configure your environment <https://docs.mirantis.com/openstack/fuel/fuel-6.1/user-guide.html#configure-your-environment>`_.
.. image:: images/scaleio-cinder-install-2.png
#. Open the **Settings tab** of the Fuel web UI and scroll down the page.
Select the Fuel plugin checkbox to enable ScaleIO Cinder plugin for Fuel:
.. image:: images/scaleio-cinder-install-4.PNG
+----------------------------+----------------------------------------------------+
| Parameter name | Parameter description |
| | |
+============================+====================================================+
| userName | The ScaleIO User name |
+----------------------------+----------------------------------------------------+
| Password | The ScaleIO password for the selected user name |
+----------------------------+----------------------------------------------------+
| ScaleIO GW IP | The IP address of the the ScaleIO Gateway service |
+----------------------------+----------------------------------------------------+
| ScaleIO Primary IP | The ScaleIO cluster's primary IP address |
+----------------------------+----------------------------------------------------+
| ScaleIO Secondary IP | The ScaleIO cluster's secondary IP address |
+----------------------------+----------------------------------------------------+
| ScaleIO protection domain | Name of the ScaleIO's protection domain |
+----------------------------+----------------------------------------------------+
| ScaleIO storage pool 1 | Name of the first storage pool |
+----------------------------+----------------------------------------------------+
.. note:: Please refer to the ScaleIO documentation for more information on these parameters.
This is an example of the ScaleIO configuration parameters populated:
.. image:: images/scaleio-cinder-install-5.PNG
#. After the configuration is done, you can add the nodes to the Openstack Deployment.
.. image:: images/scaleio-cinder-install-3.png
#. You can run the network verification check and
`deploy changes <https://docs.mirantis.com/openstack/fuel/fuel-6.1/user-guide.html#deploy-changes>`_ then.
#. After deployment is completed, you should see a success message:
.. image:: images/scaleio-cinder-install-complete.jpg
.. note:: It may take an hour or more for the OpenStack deployment
to complete, depending on your hardware configuration.