fuel-plugin-scaleio/doc/source/guide.rst

User Guide

Once the Fuel ScaleIO plugin has been installed (following the Installation Guide <installation>), you can create an OpenStack environments that uses ScaleIO as the block storage backend.

Prepare infrastructure

At least 5 nodes are required to successfully deploy Mirantis OpenStack with ScaleIO.

1. Fuel master node (w/ 50GB Disk, 2 Network interfaces [Mgmt, PXE] )
2. OpenStack Controller #1 node
3. OpenStack Controller #2 node
4. OpenStack Controller #3 node
5. OpenStack Compute node

Each node shall have at least 2 CPUs, 4GB RAM, 200GB disk, 4 Network interfaces. The 4 networks are:

1. PXE Network
2. Public Network
3. Private Network
4. Management Network

Controllers 1, 2, and 3 will be used as ScaleIO MDMs, being the primary, secondary, and tie-breaker, respectively. Moreover, they will also host the ScaleIO Gateway in HA mode.

All nodes are used as ScaleIO SDS and, therefore, contribute to the default storage pool.

Install ScaleIO GUI

It is recommended to install the ScaleIO GUI to easily access and manage the ScaleIO cluster.

1. Make sure the machine in which you will install the ScaleIO GUI has access to the Controller nodes.

2. Download the ScaleIO for your operating system from the following link: http://www.emc.com/products-solutions/trial-software-download/scaleio.htm

3. Unzip the file and install the ScaleIO GUI component.

4. Once installed, run the application and you will be prompted with the following login window. We will use it once the deployment is completed.

   

Select Environment

1. 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.

   

2. Add VMs to the new environment according to Fuel User Guide and configure them properly.

Plugin configuration

1. Go to the Settings tab and scroll down to "ScaleIO plugin" section. You need to fill all fields with your preferred ScaleIO configuration. If you do not know the purpose of a field you can leave it with its default value.

   

2. 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

1. Go to the Network tab and configure the network according to your environment.

2. Run network verification check

   

3. Press Deploy button once you have finished reviewing the environment configuration.

   

4. After deployment is done, you will see a message indicating the result of the deployment.

   

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.

1. Login into the OpenStack cluster:

2. Review the block storage services by navigating to the "Admin -> System -> System Information" section. You should see the "@ScaleIO" appended to all cinder-volume hosts.

   

3. Review the System Volumes by navigating to "Admin -> System -> Volumes". You should see a volume type called "sio_thin" with the following extra specs.

   

4. In the ScaleIO GUI (see Install ScaleIO GUI section <scaleiogui>), enter the IP address of the primary controller node, username admin, and the password you entered in the Fuel UI.

5. Once logged in, verify that it successfully reflects the ScaleIO resources:

   

6. Click on the "Backend" tab and verify all SDS nodes:

   

7. Create a new OpenStack volume using the "sio_thin" volume type.

8. In the ScaleIO GUI, you will see that there is one volume defined but none have been mapped yet.

   

9. Once the volume is attached to a VM, the ScaleIO GUI will reflect the mapping.