Updating documents of D-release.
[kvmfornfv.git] / docs / releasenotes / release-notes.rst
index f49cd08..c52b4b8 100644 (file)
@@ -10,23 +10,23 @@ Release Notes
 Abstract
 ---------
 
-This document provides the release notes for Danube 1.0 release of KVMFORNFV.
+This document provides the release notes for Danube 1.0 release of KVM4NFV.
 
 
 **Contents**
 
- 1  Version History
+ **1  Version History**
 
- 2  Important notes
+ **2  Important notes**
 
- 3  Summary
+ **3  Summary**
 
- 4  Delivery Data
+ **4  Delivery Data**
 
- 5  References
+ **5  References**
 
-1.  Version history
---------------------
+Version history
+---------------
 
 +--------------------+--------------------+--------------------+----------------------+
 | **Date**           | **Ver.**           | **Author**         | **Comment**          |
@@ -39,15 +39,15 @@ This document provides the release notes for Danube 1.0 release of KVMFORNFV.
 |                    |                    |                    |                      |
 +--------------------+--------------------+--------------------+----------------------+
 
-2.  Important notes
---------------------
+Important notes
+---------------
 
-The KVMFORNFV project is currently supported on the Fuel installer.
+The KVM4NFV project is currently supported on the Fuel installer.
 
-3.  Summary
-------------
+Summary
+-------
 
-This Danube 1.0 release provides *KVMFORNFV* as a framework to enhance the
+This Danube 1.0 release provides *KVM4NFV* as a framework to enhance the
 KVM Hypervisor for NFV and OPNFV scenario testing, automated in the OPNFV
 CI pipeline, including:
 
@@ -57,9 +57,11 @@ CI pipeline, including:
 
 *   Cyclictests execution to check the latency
 
-*   “os-sdn-kvm-ha”,“os-sdn-kvm-_nfv_ovs_dpdk-ha”,“os-sdn-kvm_nfv_ovs_dpdk-noha”,“os-sdn-kvm_nfv_ovs_dpdk_bar-ha”,“os-sdn-kvm_nfv_ovs_dpdk_bar-noha” Scenarios testing for high availability configuration using Fuel installer
+*   “os-nosdn-kvm-ha”,“os-nosdn-kvm_nfv_ovs_dpdk-ha”,“os-nosdn-kvm_nfv_ovs_dpdk-noha”,“os-nosdn-kvm_nfv_ovs_dpdk_bar-ha”,
+    “os-nosdn-kvm_nfv_ovs_dpdk_bar-noha” Scenarios testing for ``high availability/no-high avaliability``
+    configuration using Fuel installer
 
-* Documentation created
+* Documentation created for,
 
   * User Guide
 
@@ -67,13 +69,19 @@ CI pipeline, including:
 
   * Installation Procedure
 
-  * Release notes (this document)
+  * Release notes
+
+  * Scenarios Guide
+
+  * Design Guide
+
+  * Requirements Guide
 
-The *KVMFORNFV framework* is developed in the OPNFV community, by the
-KVMFORNFV_ team.
+The *KVM4NFV framework* is developed in the OPNFV community, by the
+KVM4NFV_ team.
 
-4.  Release Data
------------------
+Release Data
+------------
 
 +--------------------------------------+--------------------------------------+
 | **Project**                          | NFV Hypervisors-KVM                  |
@@ -92,79 +100,159 @@ KVMFORNFV_ team.
 |                                      |                                      |
 +--------------------------------------+--------------------------------------+
 
-4.1 Version change
-------------------
+Version change
+--------------
 
-4.1.1   Module version changes
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+1   Module version changes
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 This is the Danube 1.0 main release. It is based on following upstream
 versions:
 
-*   RT Kernel 4.4.6-rt14
+*   RT Kernel 4.4.50-rt62
 
 *   QEMU 2.6
 
 *   Fuel plugin based on Fuel 10.0
 
-This is the second tracked release of KVMFORNFV
+This is the second tracked release of KVM4NFV
 
 
-4.1.2   Document version changes
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-This is the initial version of the KVMFORNFV framework in OPNFV.
+2   Document version changes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+This is the second version of the KVM4NFV framework in OPNFV.
 
-4.2 Reason for version
-----------------------
+Reason for version
+------------------
 
-4.2.1 Feature additions
-~~~~~~~~~~~~~~~~~~~~~~~
+1 Feature additions
+~~~~~~~~~~~~~~~~~~~
 
 +--------------------------------------+--------------------------------------+
 | **JIRA REFERENCE**                   | **SLOGAN**                           |
 |                                      |                                      |
 +--------------------------------------+--------------------------------------+
-| JIRA:                                | NFV Hypervisors-KVMKVMFORNFV-57      |
+| JIRA:                                | NFV Hypervisors-KVMFORNFV-57         |
 |                                      |                                      |
 +--------------------------------------+--------------------------------------+
-| JIRA:                                | NFV Hypervisors-KVMKVMFORNFV-58      |
+| JIRA:                                | NFV Hypervisors-KVMFORNFV-58         |
 |                                      |                                      |
 +--------------------------------------+--------------------------------------+
-| JIRA:                                | NFV Hypervisors-KVMKVMFORNFV-59      |
+| JIRA:                                | NFV Hypervisors-KVMFORNFV-59         |
 |                                      |                                      |
 +--------------------------------------+--------------------------------------+
-| JIRA:                                | NFV Hypervisors-KVMKVMFORNFV-61      |
+| JIRA:                                | NFV Hypervisors-KVMFORNFV-61         |
 |                                      |                                      |
 +--------------------------------------+--------------------------------------+
-| JIRA:                                | NFV Hypervisors-KVMKVMFORNFV-62      |
+| JIRA:                                | NFV Hypervisors-KVMFORNFV-62         |
 |                                      |                                      |
 +--------------------------------------+--------------------------------------+
-| JIRA:                                | NFV Hypervisors-KVMKVMFORNFV-63      |
+| JIRA:                                | NFV Hypervisors-KVMFORNFV-63         |
 |                                      |                                      |
 +--------------------------------------+--------------------------------------+
-| JIRA:                                | NFV Hypervisors-KVMKVMFORNFV-64      |
+| JIRA:                                | NFV Hypervisors-KVMFORNFV-64         |
 |                                      |                                      |
 +--------------------------------------+--------------------------------------+
-| JIRA:                                | NFV Hypervisors-KVMKVMFORNFV-65      |
+| JIRA:                                | NFV Hypervisors-KVMFORNFV-65         |
 |                                      |                                      |
 +--------------------------------------+--------------------------------------+
 
-4.2.2 Bug corrections
-~~~~~~~~~~~~~~~~~~~~~
+A brief ``Description of the the JIRA tickets``:
+
++---------------------------------------+-------------------------------------------------------------+
+| **JIRA REFERENCE**                    | **DESCRIPTION**                                             |
+|                                       |                                                             |
++---------------------------------------+-------------------------------------------------------------+
+| KVMFORNFV-57                          | CI/CD Integration into Yardstick                            |
+|                                       |                                                             |
++---------------------------------------+-------------------------------------------------------------+
+| KVMFORNFV-58                          | Complete the integration of test plan into Yardstick        |
+|                                       | and Jenkins infrastructure to include latency testing       |
+|                                       |                                                             |
++---------------------------------------+-------------------------------------------------------------+
+| KVMFORNFV-59                          | Enable capability to publish results on Yardstick Dashboard |
+|                                       |                                                             |
++---------------------------------------+-------------------------------------------------------------+
+| KVMFORNFV-61                          | Define and integrate additional scenario - KVM+OVS+DPDK     |
+|                                       | with HA and NOHA for baremetal and virtual environments     |
+|                                       |                                                             |
++---------------------------------------+-------------------------------------------------------------+
+| KVMFORNFV-62                          | Define and integrate additional scenario - KVM+OVS+DPDK+BAR |
+|                                       | with HA and NOHA for bare metal and virtual environments    |
+|                                       |                                                             |
++---------------------------------------+-------------------------------------------------------------+
+| KVMFORNFV-63                          | Setup Local fuel environment                                |
+|                                       |                                                             |
++---------------------------------------+-------------------------------------------------------------+
+| KVMFORNFV-64                          | Fuel environment setup for local machine to debug Fuel      |
+|                                       | related integration issues                                  |
++---------------------------------------+-------------------------------------------------------------+
+
+Deliverables
+------------
+
+1   Software deliverables
+~~~~~~~~~~~~~~~~~~~~~~~~~
+* Danube 1.0 release of the KVM4NFV RPM and debian for kvm4nfv
+
+* Added the following scenarios as part of D-Release:
+
+  * os-nosdn-kvm_nfv_ovs_dpdk-noha
+
+  * os-nosdn-kvm_nfv_ovs_dpdk_bar-noha
+
+  * os-nosdn-kvm_nfv_ovs_dpdk-ha
+
+  * os-nosdn-kvm_nfv_ovs_dpdk_bar-ha
+
+* Configured influxdb and `Graphana dashboard`_ for publishing kvm4nfv test results
 
-Initial Release
+.. _Graphana_dashboard: http://testresults.opnfv.org/grafana/dashboard/db/kvmfornfv-cyclictest
 
-4.3 Deliverables
-----------------
+* Cyclictest test case is successfully implemented, it has the below test types.,
 
-4.3.1   Software deliverables
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Danube 1.0 release of the KVMFORNFV RPM and debian for Fuel.
+  * idle-idle
 
-4.3.2   Documentation deliverables
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+  * CPUstress-idle
 
-The below documents are delivered for Danube KVMFORNFV Release:
+  * IOstress-idle
+
+  * Memorystress-idle
+
+* Implemented Noisy Neighbour feature ., cyclictest under stress testing is implemented
+
+* Packet forwarding test case is implemented and it supports the following test types currently,
+
+  * Packet forwarding to Host
+
+  * Packet forwarding to Guest
+
+  * Packet forwarding to Guest using SRIOV
+
+* Ftrace debugging tool is supported in D-Release. The logs collected by ftrace are stored in artifacts for future needs
+
+* PCM Utility is part of D-Release. The future scope may include collection of read/write data and publishing in grafana
+
+* Either Apex or Fuel can be used for deployment of os-nosdn-kvm-ha scenario
+
++------------------------------------------+------------------+-----------------+
+| **Scenario Name**                        | **Apex**         | **Fuel**        |
+|                                          |                  |                 |
++==========================================+==================+=================+
+| - os-nosdn-kvm-ha                        |     ``Y``        |     ``Y``       |
++------------------------------------------+------------------+-----------------+
+| - os-nosdn-kvm_nfv_ovs_dpdk-noha         |                  |     ``Y``       |
++------------------------------------------+------------------+-----------------+
+| - os-nosdn-kvm_nfv_ovs_dpdk-ha           |                  |     ``Y``       |
++------------------------------------------+------------------+-----------------+
+| - os-nosdn-kvm_nfv_ovs_dpdk_bar-noha     |                  |     ``Y``       |
++------------------------------------------+------------------+-----------------+
+| - os-nosdn-kvm_nfv_ovs_dpdk_bar-ha       |                  |     ``Y``       |
++------------------------------------------+------------------+-----------------+
+
+* Future scope may include adding Apex support for all the remaining scenarios
+
+* The below documents are delivered for Danube KVM4NFV Release:
 
   * User Guide
 
@@ -174,15 +262,19 @@ The below documents are delivered for Danube KVMFORNFV Release:
 
   * Overview
 
-  * Release notes (this document)
+  * Release notes
 
   * Glossary
 
   * Scenarios
 
-5. References
---------------
+  * Requirements Guide
+
+  * Overview Guide
+
+References
+----------
 
-For more information on the KVMFORNFV Danube release, please see:
+For more information on the KVM4NFV Danube release, please see:
 
 https://wiki.opnfv.org/display/kvm/