User_stories and feature requests appended to sphinx

  also some markup fixes to treat toctree look

Change-Id: Ibeac44a79e60dc6b2d82259a199856ad67c5fc36
Sahara Cluster and EDP contexts

These contexts will be used to setup Sahara EDP resources before executing
the Job.

The Cluster context will launch a cluster for each tenant.

The EDP context will set up:
* Data Sources for the input and the output
* Job Binaries to run a job from

Note: A refactoring is done to move Sahara contexts under a separate
module.
Note: The contexts do not start any executions.

Change-Id: I8a7420fcc5fc06eaf70a3f1ad4f573a2811ce303
Sahara Job Execution benchmark

The benchmark for job execution added.

Change-Id: Iac251de92413f0f1fe1c872b5183c91e40eb1232
Add a cinder volume attachment scenario

This required me to add some new nova utils methods for
doing a volume attach/detach.

Change-Id: I39fba30e1324f23958d34e03b5aa57084c56d6e6
Add nova scenarios to rally-neutron.yaml

rally-neutron.yaml should contains more scenarios for better verification of neutron.

Related-Bug: #1353622

Change-Id: I2d3c7c94cccc5fda83cc242fd69265a5f6a48b9b
Merge "Add a cinder volume attachment scenario"
Merge "User_stories and feature requests appended to sphinx"
Merge "Sahara Cluster and EDP contexts"
Merge "Add nova scenarios to rally-neutron.yaml"
Moved preprocess function from base to types

The preprocess function was moved from benchmark.runners
.base to benchmark.types. Decoupling the preprocess
function from base removes a dependency in code.

A unit test for preprocess has also been added to
test_types.py.

Change-Id: I311316c667bb6256ea5f0a32e24328102b62c6e8
Add @validation.require_openstack() validator

This patch removes from @base.scenario(admin_only=False) argument.
That actually doesn't work and doesn't cover situation when we need
only users or admins or admins & users..

Add proper @require_openstack validator that actually checks
everything that is required.
So you can specify that only users or admin is required or both
users and admin are required.

Add missing "users" context in rally-scenario for scenarios that
use it.

Add missing "sla" sections in benchmarks

Reduce amount of iterations in "rps" benchmark

Change-Id: Ie92dbd473ee94c2073401c6da8dc2771c9dfaed8
Fix ping_ip_address method in order to be run under BSDs

Modify the ping command used in the ping_ip_address static method in
order to be run also under BSD systems.

Closes-Bug: 1369527
Change-Id: Iac9ef4ab26fca6ca628159569a86c5af089a225a
Merge "Fix ping_ip_address method in order to be run under BSDs"
Add hacking checks

Checking specific mistakes can be automated via hacking rules.

This patch:
 * adds HACKING.rst - list of rules;
 * adds rally.hacking - module for implementation of rules;
 * edits tox.ini, so hacking rules will be checked during pep8 test;
 * adds 3 rules related to mistakes in  `assert_*` methods from `mock`
   library. Also tests, which are failed due to these rules, are fixed.

Closes-Bug: #1305991
Change-Id: I605dd5cfba4eb83d0735e4f9f3ab4e44e149d041
Rally cli functional testing

  Added test for:
    'rally deployment'
    'rally show'
    'rally info'
    'rally task'

  test_cli was parted

  blueprint tests-integrated

Change-Id: If9febf155d8178b5c941317d2a7b837bbce128f1
Merge "Add hacking checks"
Fix "rally info" failure in case of empty docstrings

In case the input query for "rally info find ... " requested for a benchmark
scenario with an empty docstring, the CLI failed with an exception. Instead,
we should print that there is no info about that scenario.

Change-Id: If3a806f794f9b11ce1eb44eaabce732183c4c99b
Closes-Bug: 1371461
Updated from global requirements

Change-Id: Ia70bbde29c81f9fbfa0def64e46eba309ef6a147
update rally.conf.sample

Change-Id: I5d1ebfac06a024de673914ada7e5b30525bacc19
Merge "Fix "rally info" failure in case of empty docstrings"