fuel-plugin-scaleio-cinder/doc/content/user-guide.rst

122 lines
3.3 KiB
ReStructuredText

.. raw:: pdf
PageBreak
===========================================================
User Guide
===========================================================
#. Install ScaleIO-Cinder plugin using the `Installation Guide <./installation.rst>`_.
#. Create environment with enabled plugin in fuel ui, lunch the fuel
site and check setting section to make sure the Scaleio-Cinder
section exists
#. Add 3 nodes with Controller role and 1 node with Compute and another
role:
.. image:: images/installation/image006.png
:width: 50%
#. Picture of the External ScaleIO Cluster Running:
.. image:: images/installation/image007.png
:width: 50%
#. Retrive the external ScaleIO Cluster information. For
our example these are the configuration settings:
.. image:: images/installation/image007.png
:width: 50%
#. Use the ScaleIO Cluster information to update the ScaleIO Plugin
information:
.. image:: images/installation/image009.png
:width: 50%
#. Apply network settings
#. Use the networking settings that are appropriate for your
environment. For our example we used the default settings provided
by Fuel:
.. image:: images/installation/image010.png
:width: 50%
#. Run network verification check:
.. image:: images/installation/image011.png
:width: 50%
#. Deploy the cluster:
.. image:: images/installation/image012.png
:width: 50%
#. Once the deployment finished successfully, open OpenStack Dashboard (Horizon):
.. image:: images/installation/image013.png
:width: 50%
#. Check Storage tab under system information and make sure ScaleIO
service is up and running:
.. image:: images/installation/image014.png
:width: 50%
ScaleIO Cinder plugin OpenStack operations
==========================================
Once the OpenStack Cluster is setup, we can setup ScaleIO Volumes. This
is an example in how to attach a Volume to a running VM:
#. Login into the OpenStack Cluster:
.. image:: images/scaleio-cinder-install-6.PNG
:alt: OpenStack Login
:width: 50%
#. Review the Block storage services by navigating: Admin -> System ->
System Information secction. You should see the ScaleIO Cinder
Volume.
.. image:: images/scaleio-cinder-install-7.PNG
:alt: Block Storage Services Verification
:width: 50%
#. Review the System Volumes by navigating to: Admin -> System ->
Volumes. You should see the ScaleIO Volume Type:
.. image:: images/scaleio-cinder-install-8.PNG
:alt: Volume Type Verification
:width: 50%
#. Create a new OpenStack Volume:
.. image:: images/scaleio-cinder-install-9.PNG
:alt: Volume Creation
:width: 50%
#. View the newly created Volume:
.. image:: images/scaleio-cinder-install-10.PNG
:alt: Volume Listing
:width: 50%
#. In the ScaleIO Control Panel, you will see that no Volumes have been
mapped yet:
.. image:: images/scaleio-cinder-install-11.PNG
:alt: ScaleIO UI No mapped Volumes
:width: 50%
#. Once the Volume is attached to a VM, the ScaleIO UI will reflect the
mapping:
.. image:: images/scaleio-cinder-install-12.png
:alt: ScaleIO UI Mapped Volume
:width: 50%