Updated user guide. Images are still missing.

Change-Id: Ic9cedcb50c1dc2eb630c841a0c48e7d1392910a5
This commit is contained in:
Adrian Moreno 2015-11-09 13:00:16 +01:00
parent 32bf4a7d46
commit 6c7a81c4ea
3 changed files with 65 additions and 4 deletions

View File

@ -14,24 +14,30 @@ TODO
Select Environment
------------------
#. Create a new environment with the Fuel UI wizard. Select "Juno on CentOS 6.5" from OpenStack Release dropdown list. At the moment you will see most of options are disabled in the wizard.
#. Create a new environment with the Fuel UI wizard. Select "Juno on CentOS 6.5" from OpenStack Release dropdown list and continue until you finish with the wizard.
.. image:: images/wizard.png
:width: 80%
#. Add VMs to the new environment according to `Fuel User Guide <https://docs.mirantis.com/openstack/fuel/fuel-6.1/user-guide.html#add-nodes-to-the-environment>`_ and configure them properly.
#. Go to Settings tab and scroll down to "ScaleIO Fuel Plugin" section. You need to fill all fields with your configuration parameters. If you don't know the purpose of a field you can leave it with its default value.
Plugin configuration
--------------------
#. Go to the Settings tab and scroll down to "ScaleIO Fuel Plugin" section. You need to fill all fields with your preferred ScaleIO configuration. If you don't know the purpose of a field you can leave it with its default value.
.. image:: images/settings.png
:width: 80%
#. TODO
#. Take the time to review and configure other environment settings such as the DNS and NTP servers, URLs for the repositories, etc.
Finish environment configuration
--------------------------------
#. Go to the Network tab and configure the network according to your environment.
#. Run `network verification check <https://docs.mirantis.com/openstack/fuel/fuel-6.1/user-guide.html#verify-networks>`_
#. Press `Deploy button <https://docs.mirantis.com/openstack/fuel/fuel-6.1/user-guide.html#deploy-changes>`_ to once you are done with environment configuration.
@ -40,3 +46,44 @@ Finish environment configuration
.. image:: images/horizon.png
:width: 80%
ScaleIO verification
--------------------
Once the OpenStack cluster is setup, we can make use of ScaleIO volumes. This is an example about how to attach a volume to a running VM.
#. Login into the OpenStack Cluster:
.. image:: images/horizon-login.png
:width: 80%
#. Review the block storage services by navigating to the "Admin -> System -> System Information" section. You should see the ScaleIO volume.
.. image:: images/block-storage-services.png
:width: 80%
#. Review the System Volumes by navigating to "Admin -> System -> Volumes". You should see the ScaleIO volume type:
.. image:: images/volume-type.png
:width: 80%
#. Create a new OpenStack volume using the ScaleIO volume type.
.. image:: images/new-volume.png
:width: 80%
#. Review the newly created volume.
.. image:: images/review-new-volume.png
:width: 80%
#. In the ScaleIO Control Panel, you will see that there is one volume defined but none have been mapped yet.
.. image:: images/sio-volume-defined.png
:width: 80%
#. Once the volume is attached to a VM, the ScaleIO Control Panel will reflect the mapping.
.. image:: images/sio-volume-mapped.png
:width: 80%

14
doc/user-guide.rst Normal file
View File

@ -0,0 +1,14 @@
Guide to the ScaleIO Plugin for Fuel 6.1
==========================================
Intro
-----
This document will guide you through the steps of install, configure and use of the ScaleIO Plugin for Fuel
Sections
--------
.. include:: content/introduction.rst
.. include:: content/installation.rst
.. include:: content/user-guide.rst
.. include:: content/appendix.rst

View File

@ -3,7 +3,7 @@ name: scaleio
# Human-readable name for your plugin
title: Fuel plugin for ScaleIO
# Plugin version
version: '0.2.0'
version: '0.2.1'
# Description
description: Enable ScaleIO as a storage backend
# Required fuel version