summaryrefslogtreecommitdiffstats
path: root/docs/release
diff options
context:
space:
mode:
authormbeierl <mark.beierl@dell.com>2018-05-04 14:04:51 -0400
committermbeierl <mark.beierl@dell.com>2018-05-10 10:53:55 -0400
commit1942e374fba718d1d4b6bc5388803c75e71aa197 (patch)
tree045c15e23ef5def85f765df863f9b342cebc713a /docs/release
parent64c8b3b561ccac6159241cd0485a3259887c6bb0 (diff)
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>
Diffstat (limited to 'docs/release')
-rw-r--r--docs/release/release-notes/release-notes.rst64
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>`_