Adds Volume Count and Dynamic Reload

Adds a volume_count parameter that allows the user to
change the number of volumes.  Test execution still
uses each volume specified and appends it to the host
ip address in the graphite metrics.

Changes the cache policy of the stack from SNAPS-OO
so that changes made to the stack are refelcted in
StorPerf.

Fixes the documentation path and updates the docs
for the above changes.

Change-Id: I5b9160b469e80d4f7d6906ac270bb3b75411fb5a
JIRA: STORPERF-242
Signed-off-by: mbeierl <mark.beierl@dell.com>

1 files changed, 45 insertions, 19 deletions

diff --git a/docs/release/release-notes/release-notes.rst b/docs/release/release-notes/release-notes.rst
index c0ad0b8..d80e421 100644
--- a/docs/release/release-notes/release-notes.rst
+++ b/docs/release/release-notes/release-notes.rst
@@ -2,7 +2,7 @@
 .. http://creativecommons.org/licenses/by/4.0
 
 
-This document provides the release notes for Euphrates 1.0 of StorPerf.
+This document provides the release notes for Fraser 2.0 of StorPerf.
 
 .. contents::
    :depth: 3
@@ -20,14 +20,19 @@ Version history
 | 2018-04-18         | Fraser 1.0         | Mark Beierl        |                    |
 |                    |                    |                    |                    |
 +--------------------+--------------------+--------------------+--------------------+
+| 2018-05-18         | Fraser 2.0         | Mark Beierl        |                    |
+|                    |                    |                    |                    |
++--------------------+--------------------+--------------------+--------------------+
 
 
 Important notes
 ----------------
 
-This is the release where StorPerf is not delivered as a single container but
-is delivered as a series of networked containers. StorPerf must be run using
-docker-compose.
+StorPerf has added the ability to specify the number of Cinder Volumes per
+agent VM to test.  The name of the device that the volume is attached to
+has been appended to the host IP address in the metrics so that it can be
+tracked independently.
+
 
 Summary
 --------
@@ -36,10 +41,22 @@ StorPerf is a standalone framework that uses OpenStack to measure Cinder volume
 performance.  If desired, it can push results to the OPNFV Test Results DB, or
 the embedded Graphite web interface can be used to perform ad hoc queries.
 
-This release changes to docker-compose framework and adds the StorPerf
-reporting module.  It also marks a change from microsecond (:math:`\mu`\s) to
-nano-second (ns) precision for all reported latencies.  This is denoted by a change
-from lat.mean to lat_ns.mean for read and write metrics.
+This release allows for changing of stack attributes from the OpenStack CLI.
+Using a command such as
+
+.. code-block::
+  heat stack-update StorPerfAgentGroup --existing -P "agent_count=6"
+
+will change the existing stack to use 6 agents.  Note that StorPerf can take
+up to 1 minute after the stack update is complete before detecting the new
+values.  Please use a GET of the configurations API to test for updated
+values prior to submitting a new test.
+
+The following command changes the number of volumes per agent:
+
+.. code-block::
+  heat stack-update StorPerfAgentGroup --existing -P "volume_count=2"
+
 
 Release Data
 -------------
@@ -48,16 +65,16 @@ Release Data
 | **Project**                          | StorPerf                             |
 |                                      |                                      |
 +--------------------------------------+--------------------------------------+
-| **Repo/commit-ID**                   | storperf/fraser.1.0               |
+| **Repo/commit-ID**                   | storperf/fraser.2.0                  |
 |                                      |                                      |
 +--------------------------------------+--------------------------------------+
-| **Release designation**              | Fraser base release               |
+| **Release designation**              | Fraser base release                  |
 |                                      |                                      |
 +--------------------------------------+--------------------------------------+
-| **Release date**                     | 2017-10-06                           |
+| **Release date**                     | 2018-05-18                           |
 |                                      |                                      |
 +--------------------------------------+--------------------------------------+
-| **Purpose of the delivery**          | OPNFV Fraser release 1.0          |
+| **Purpose of the delivery**          | OPNFV Fraser release 2.0             |
 |                                      |                                      |
 +--------------------------------------+--------------------------------------+
 
@@ -75,7 +92,8 @@ Reason for version
 Features additions
 -------------------
 
-* STORPERF-231 - Integration with SNAPS
+* STORPERF-242 - Allow user to change stack parameters outside of StorPerf
+
 
 Bug Fixes
 ----------
@@ -87,19 +105,19 @@ Software
 ---------
 
 - `StorPerf master image <https://hub.docker.com/r/opnfv/storperf-master/>`_
-  (tag: x86_64-fraser.1.0  or aarch64-fraser.1.0)
+  (tag: x86_64-fraser.2.0  or aarch64-fraser.2.0)
 
 - `StorPerf swaggerui <https://hub.docker.com/r/opnfv/storperf-swaggerui/>`_
-  (tag: x86_64-fraser.1.0  or aarch64-fraser.1.0)
+  (tag: x86_64-fraser.2.0  or aarch64-fraser.2.0)
 
 - `StorPerf graphite image <https://hub.docker.com/r/opnfv/storperf-graphite/>`_
-  (tag: x86_64-fraser.1.0  or aarch64-fraser.1.0)
+  (tag: x86_64-fraser.2.0  or aarch64-fraser.2.0)
 
 - `StorPerf reporting image <https://hub.docker.com/r/opnfv/storperf-reporting/>`_
-  (tag: x86_64-fraser.1.0  or aarch64-fraser.1.0)
+  (tag: x86_64-fraser.2.0  or aarch64-fraser.2.0)
 
 - `StorPerf Http-Frontend image <https://hub.docker.com/r/opnfv/storperf-httpfrontend/>`_
-  (tag: x86_64-fraser.1.0  or aarch64-fraser.1.0)
+  (tag: x86_64-fraser.2.0  or aarch64-fraser.2.0)
 
 Documentation
 --------------
@@ -119,9 +137,17 @@ Known issues
 
 * Cirros target VMs do not always mount Cinder volumes on first boot.  Sometimes
   a reboot of the VM is required to properly attach the Cinder volume to /dev/vdb
+* A bug in the linux kernel can prevent Cinder volumes from attaching to VMs
+  using ARM architecture.  Specifying the following properties in Glance for
+  the ARM based image will work around this problem.  Note: this will cause
+  the device to show up as a SCSI device and therefore will be /dev/sdb instead
+  of /dev/vdb.
+
+.. code-block:
+  --property hw_disk_bus=scsi --property hw_scsi_model=virtio-scsi
 
 
 Test Result
 ===========
 
-- `OPNFV Test Results DB <http://testresults.opnfv.org/reporting/euphrates/storperf/status-apex.html>`_
+- `OPNFV Test Results DB <http://testresults.opnfv.org/reporting/fraser/storperf/status-apex.html>`_