docs/release/release-notes/release-notes.rst

   1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
   2 .. http://creativecommons.org/licenses/by/4.0
   3
   4 .. _Kvmfornfv: https://wiki.opnfv.org/display/kvm/
   5
   6 =============
   7 Release Notes
   8 =============
   9
  10 Abstract
  11 ---------
  12
  13 This document provides the release notes for Danube 1.0 release of KVM4NFV.
  14
  15
  16 **Contents**
  17
  18  **1  Version History**
  19
  20  **2  Important notes**
  21
  22  **3  Summary**
  23
  24  **4  Delivery Data**
  25
  26  **5  References**
  27
  28 Version history
  29 ---------------
  30
  31 +--------------------+--------------------+--------------------+----------------------+
  32 | **Date**           | **Ver.**           | **Author**         | **Comment**          |
  33 |                    |                    |                    |                      |
  34 +--------------------+--------------------+--------------------+----------------------+
  35 |2016-08-22          | 0.1.0              |                    | Colorado 1.0 release |
  36 |                    |                    |                    |                      |
  37 +--------------------+--------------------+--------------------+----------------------+
  38 |2017-03-27          | 0.1.0              |                    | Danube 1.0 release   |
  39 |                    |                    |                    |                      |
  40 +--------------------+--------------------+--------------------+----------------------+
  41
  42 Important notes
  43 ---------------
  44
  45 The KVM4NFV project is currently supported on the Fuel installer.
  46
  47 Summary
  48 -------
  49
  50 This Danube 1.0 release provides *KVM4NFV* as a framework to enhance the
  51 KVM Hypervisor for NFV and OPNFV scenario testing, automated in the OPNFV
  52 CI pipeline, including:
  53
  54 *   KVMFORNFV source code
  55
  56 *   Automation of building the Kernel and qemu for RPM and debian packages
  57
  58 *   Cyclictests execution to check the latency
  59
  60 *   “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”,
  61     “os-nosdn-kvm_nfv_ovs_dpdk_bar-noha” Scenarios testing for ``high availability/no-high avaliability``
  62     configuration using Fuel installer
  63
  64 * Documentation created for,
  65
  66   * User Guide
  67
  68   * Configuration Guide
  69
  70   * Installation Procedure
  71
  72   * Release notes
  73
  74   * Scenarios Guide
  75
  76   * Design Guide
  77
  78   * Requirements Guide
  79
  80
  81 Release Data
  82 ------------
  83
  84 +--------------------------------------+--------------------------------------+
  85 | **Project**                          | NFV Hypervisors-KVM                  |
  86 |                                      |                                      |
  87 +--------------------------------------+--------------------------------------+
  88 | **Repo/commit-ID**                   | kvmfornfv                            |
  89 |                                      |                                      |
  90 +--------------------------------------+--------------------------------------+
  91 | **Release designation**              | Danube                               |
  92 |                                      |                                      |
  93 +--------------------------------------+--------------------------------------+
  94 | **Release date**                     | 2017-03-27                           |
  95 |                                      |                                      |
  96 +--------------------------------------+--------------------------------------+
  97 | **Purpose of the delivery**          | OPNFV Danube 1.0 Releases            |
  98 |                                      |                                      |
  99 +--------------------------------------+--------------------------------------+
 100
 101 Version change
 102 --------------
 103
 104 1   Module version changes
 105 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 106
 107 This is the Danube 1.0 main release. It is based on following upstream
 108 versions:
 109
 110 *   RT Kernel 4.4.50-rt62
 111
 112 *   QEMU 2.6
 113
 114 *   Fuel plugin based on Fuel 10.0
 115
 116 This is the second tracked release of KVM4NFV
 117
 118
 119 2   Document version changes
 120 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 121 This is the second version of the KVM4NFV framework in OPNFV.
 122
 123 Reason for version
 124 ------------------
 125
 126 1 Feature additions
 127 ~~~~~~~~~~~~~~~~~~~
 128
 129 +--------------------------------------+--------------------------------------+
 130 | **JIRA REFERENCE**                   | **SLOGAN**                           |
 131 |                                      |                                      |
 132 +--------------------------------------+--------------------------------------+
 133 | JIRA:                                | NFV Hypervisors-KVMFORNFV-57         |
 134 |                                      |                                      |
 135 +--------------------------------------+--------------------------------------+
 136 | JIRA:                                | NFV Hypervisors-KVMFORNFV-58         |
 137 |                                      |                                      |
 138 +--------------------------------------+--------------------------------------+
 139 | JIRA:                                | NFV Hypervisors-KVMFORNFV-59         |
 140 |                                      |                                      |
 141 +--------------------------------------+--------------------------------------+
 142 | JIRA:                                | NFV Hypervisors-KVMFORNFV-61         |
 143 |                                      |                                      |
 144 +--------------------------------------+--------------------------------------+
 145 | JIRA:                                | NFV Hypervisors-KVMFORNFV-62         |
 146 |                                      |                                      |
 147 +--------------------------------------+--------------------------------------+
 148 | JIRA:                                | NFV Hypervisors-KVMFORNFV-63         |
 149 |                                      |                                      |
 150 +--------------------------------------+--------------------------------------+
 151 | JIRA:                                | NFV Hypervisors-KVMFORNFV-64         |
 152 |                                      |                                      |
 153 +--------------------------------------+--------------------------------------+
 154 | JIRA:                                | NFV Hypervisors-KVMFORNFV-65         |
 155 |                                      |                                      |
 156 +--------------------------------------+--------------------------------------+
 157
 158 A brief ``Description of the the JIRA tickets``:
 159
 160 +---------------------------------------+-------------------------------------------------------------+
 161 | **JIRA REFERENCE**                    | **DESCRIPTION**                                             |
 162 |                                       |                                                             |
 163 +---------------------------------------+-------------------------------------------------------------+
 164 | KVMFORNFV-57                          | CI/CD Integration into Yardstick                            |
 165 |                                       |                                                             |
 166 +---------------------------------------+-------------------------------------------------------------+
 167 | KVMFORNFV-58                          | Complete the integration of test plan into Yardstick        |
 168 |                                       | and Jenkins infrastructure to include latency testing       |
 169 |                                       |                                                             |
 170 +---------------------------------------+-------------------------------------------------------------+
 171 | KVMFORNFV-59                          | Enable capability to publish results on Yardstick Dashboard |
 172 |                                       |                                                             |
 173 +---------------------------------------+-------------------------------------------------------------+
 174 | KVMFORNFV-61                          | Define and integrate additional scenario - KVM+OVS+DPDK     |
 175 |                                       | with HA and NOHA for baremetal and virtual environments     |
 176 |                                       |                                                             |
 177 +---------------------------------------+-------------------------------------------------------------+
 178 | KVMFORNFV-62                          | Define and integrate additional scenario - KVM+OVS+DPDK+BAR |
 179 |                                       | with HA and NOHA for bare metal and virtual environments    |
 180 |                                       |                                                             |
 181 +---------------------------------------+-------------------------------------------------------------+
 182 | KVMFORNFV-63                          | Setup Local fuel environment                                |
 183 |                                       |                                                             |
 184 +---------------------------------------+-------------------------------------------------------------+
 185 | KVMFORNFV-64                          | Fuel environment setup for local machine to debug Fuel      |
 186 |                                       | related integration issues                                  |
 187 +---------------------------------------+-------------------------------------------------------------+
 188
 189 Deliverables
 190 ------------
 191
 192 1   Software deliverables
 193 ~~~~~~~~~~~~~~~~~~~~~~~~~
 194 * Danube 1.0 release of the KVM4NFV RPM and debian for kvm4nfv
 195
 196 * Added the following scenarios as part of D-Release:
 197
 198   * os-nosdn-kvm_nfv_ovs_dpdk-noha
 199
 200   * os-nosdn-kvm_nfv_ovs_dpdk_bar-noha
 201
 202   * os-nosdn-kvm_nfv_ovs_dpdk-ha
 203
 204   * os-nosdn-kvm_nfv_ovs_dpdk_bar-ha
 205
 206 * Configured influxdb and `Graphana_dashboard`_ for publishing kvm4nfv test results
 207
 208 .. _Graphana_dashboard: http://testresults.opnfv.org/grafana/dashboard/db/kvmfornfv-cyclictest
 209
 210 * Cyclictest test case is successfully implemented, it has the below test types.,
 211
 212   * idle-idle
 213
 214   * CPUstress-idle
 215
 216   * IOstress-idle
 217
 218   * Memorystress-idle
 219
 220 * Implemented Noisy Neighbour feature ., cyclictest under stress testing is implemented
 221
 222 * Packet forwarding test case is implemented and it supports the following test types currently,
 223
 224   * Packet forwarding to Host
 225
 226   * Packet forwarding to Guest
 227
 228   * Packet forwarding to Guest using SRIOV
 229
 230 * Ftrace debugging tool is supported in D-Release. The logs collected by ftrace are stored in artifacts for future needs
 231
 232 * PCM Utility is part of D-Release. The future scope may include collection of read/write data and publishing in grafana
 233
 234 * Either Apex or Fuel can be used for deployment of os-nosdn-kvm-ha scenario
 235
 236 +------------------------------------------+------------------+-----------------+
 237 | **Scenario Name**                        | **Apex**         | **Fuel**        |
 238 |                                          |                  |                 |
 239 +==========================================+==================+=================+
 240 | - os-nosdn-kvm-ha                        |     ``Y``        |     ``Y``       |
 241 +------------------------------------------+------------------+-----------------+
 242 | - os-nosdn-kvm_nfv_ovs_dpdk-noha         |                  |     ``Y``       |
 243 +------------------------------------------+------------------+-----------------+
 244 | - os-nosdn-kvm_nfv_ovs_dpdk-ha           |                  |     ``Y``       |
 245 +------------------------------------------+------------------+-----------------+
 246 | - os-nosdn-kvm_nfv_ovs_dpdk_bar-noha     |                  |     ``Y``       |
 247 +------------------------------------------+------------------+-----------------+
 248 | - os-nosdn-kvm_nfv_ovs_dpdk_bar-ha       |                  |     ``Y``       |
 249 +------------------------------------------+------------------+-----------------+
 250
 251 * Future scope may include adding Apex support for all the remaining scenarios
 252
 253 * The below documents are delivered for Danube KVM4NFV Release:
 254
 255   * User Guide
 256
 257   * Configuration Guide
 258
 259   * Installation Procedure
 260
 261   * Overview
 262
 263   * Release notes
 264
 265   * Glossary
 266
 267   * Scenarios
 268
 269   * Requirements Guide
 270
 271   * Overview Guide
 272
 273 References
 274 ----------
 275
 276 For more information on the KVM4NFV Danube release, please see:
 277
 278 https://wiki.opnfv.org/display/kvm/