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

   1 .. This work is licensed under a Creative Commons Attribution 4.0 International
   2 .. License.
   3 .. http://creativecommons.org/licenses/by/4.0
   4 .. (c) OPNFV, Intel Corporation and others.
   5
   6
   7 OPNFV Jerma Release
   8 ===================
   9 * The only supported test VNF in this release for dataplane benchmarking purposes is PROX
  10 * PROX supporting up to DPDK:20.05
  11 * Introducing ability to make test cloud-configured dataplane networking benchmarks using
  12   ETSI NFV TST009 standard methods
  13 * Test automation using X-testing
  14
  15
  16 OPNFV Hunter Release
  17 ======================
  18
  19 This Hunter release provides *SampleVNF* as a approx VNF repository for
  20 VNF/NFVI testing, characterization and OPNFV feature testing, automated on
  21 OPNFV platform, including:
  22
  23 * Documentation generated with Sphinx
  24
  25   * User Guide
  26
  27   * Developer Guide
  28
  29   * Release notes (this document)
  30
  31   * Results
  32
  33 * Automated SampleVNF test suit in OPNFV Yardstick_ Project
  34
  35 * SampleVNF source code
  36
  37 For Hunter release, the *SampleVNF* supported:
  38
  39 +----------------+---------------------------------------------------------+-------------------+
  40 | *VNF*          |                 *Name*                                  |    *version*      |
  41 +----------------+---------------------------------------------------------+-------------------+
  42 | *CGNAPT*       | Carrier Grade Network Address and port Translation .5.0 |     v0.1.0        |
  43 +----------------+---------------------------------------------------------+-------------------+
  44 | *Prox*         | Packet pROcessing eXecution engine                      |     v0.40.0       |
  45 |                |  acts as traffic generator, L3FWD, L2FWD, BNG etc       |                   |
  46 +----------------+---------------------------------------------------------+-------------------+
  47 | *vACL*         | Access Control List                                     |     v0.1.0        |
  48 +----------------+---------------------------------------------------------+-------------------+
  49 | *vFW*          | Firewall                                                |     v0.1.0        |
  50 +----------------+---------------------------------------------------------+-------------------+
  51 | *UDP_replay*   | UDP_Replay                                              |     v0.1.0        |
  52 +----------------+---------------------------------------------------------+-------------------+
  53
  54 .. note:: Highlevel Desgin and features supported by each of the VNFs is described in Developer
  55           and user guide.
  56
  57 For Hunter release, the *SampleVNF* is used for the following
  58 testing:
  59
  60 * OPNFV platform testing - generic test cases to measure the categories:
  61
  62   * NFVI Characterization:
  63
  64     * Network
  65
  66   * VNF Characterization:
  67
  68     * Network - rfc2544, rfc3511, latency, http_test etc
  69
  70
  71 The *SampleVNF* is developed in the OPNFV community, by the SampleVNF_ team.
  72 The *Network Service Benchmarking* SampleVNF Characterization Testing tool is a part of the
  73 Yardstick Project.
  74
  75 .. note:: The test case description template used for the SampleVNF in yardstick
  76   test cases is based on the document ETSI-ISG NFV-TST001_; the results report template
  77   used for the SampleVNF test results is based on the IEEE Std 829-2008.
  78
  79
  80 Release Data
  81 ------------
  82
  83 +--------------------------------------+--------------------------------------+
  84 | **Project**                          | SampleVNF                            |
  85 |                                      |                                      |
  86 +--------------------------------------+--------------------------------------+
  87 | **Repo/tag**                         | opnfv-8.0                            |
  88 |                                      |                                      |
  89 +--------------------------------------+--------------------------------------+
  90 | **SampleVNF Docker image tag**       | Hunter 8.0                           |
  91 |                                      |                                      |
  92 +--------------------------------------+--------------------------------------+
  93 | **Release designation**              | Hunter 8.0                           |
  94 |                                      |                                      |
  95 +--------------------------------------+--------------------------------------+
  96 | **Release date**                     | "May 10 2019"                        |
  97 |                                      |                                      |
  98 +--------------------------------------+--------------------------------------+
  99 | **Purpose of the delivery**          | Hunter alignment to Released         |
 100 |                                      | bug-fixes for the following:         |
 101 |                                      | - Memory leak                        |
 102 |                                      | - minimum latency                    |
 103 |                                      | - Increase default mbuf size and     |
 104 |                                      |   code simplification/cleanup        |
 105 |                                      | - Crash in rx/tx distribution        |
 106 |                                      |                                      |
 107 +--------------------------------------+--------------------------------------+
 108
 109
 110 Deliverables
 111 ------------
 112
 113 Documents
 114 ^^^^^^^^^
 115
 116  - User Guide: http://artifacts.opnfv.org/samplevnf/docs/testing_user_userguide/index.html
 117
 118  - Developer Guide: http://artifacts.opnfv.org/samplevnf/docs/testing_developer/index.html
 119
 120
 121 Software Deliverables
 122 ^^^^^^^^^^^^^^^^^^^^^
 123
 124  - The SampleVNF Docker image: To be added
 125
 126
 127 **SampleVNF tested on Contexts**
 128
 129 +---------------------+-------------------------------------------------------+
 130 | **Context**         | **Description**                                       |
 131 |                     |                                                       |
 132 +---------------------+-------------------------------------------------------+
 133 | *Heat*              | Models orchestration using OpenStack Heat             |
 134 |                     |                                                       |
 135 +---------------------+-------------------------------------------------------+
 136 | *Node*              | Models Baremetal, Controller, Compute                 |
 137 |                     |                                                       |
 138 +---------------------+-------------------------------------------------------+
 139 | *Standalone*        | Models VM running on Non-Managed NFVi                 |
 140 |                     |                                                       |
 141 +---------------------+-------------------------------------------------------+
 142
 143 Document Version Changes
 144 ^^^^^^^^^^^^^^^^^^^^^^^^
 145
 146 This is the first version of the SampleVNF  in OPNFV.
 147 It includes the following documentation updates:
 148
 149 - SampleVNF User Guide:
 150
 151 - SampleVNF Developer Guide
 152
 153 - SampleVNF Release Notes for SampleVNF: this document
 154
 155
 156 Feature additions
 157 ^^^^^^^^^^^^^^^^^
 158
 159 - Support for DPDK 18.05 and DPDK 18.08
 160 - Add support for counting non dataplane related packets
 161 - test improvements and fixes for image creation
 162 - Local Documentation Builds
 163 - Improve l3fwd performance
 164 - Enable the local cache mac address
 165 - Initial support for DPDK 18.05
 166 - Adding centos.json to be used with packer to generate a VM with PROX
 167 - Adding support for Ubuntu 17.10...
 168 - Get multiple port stats simultaneously
 169 - Increase default mbuf size and code simplification/cleanup
 170 - update from src port in the pvt/pub handler
 171
 172 Bug fixes:
 173 - Fix potential crash with latency accuracy
 174 - TempFix: vCGNAPT/vACL ipv4 perf issue
 175 - Temp Fix for vFW perf issue
 176 - fix code standard in VNFs/DPPD-PROX/handle_esp.c
 177 - Workaround DPDK net/virtio queue setup issue
 178 - Fix potential crash when shuffling mbufs
 179
 180
 181 Known Issues/Faults
 182 ^^^^^^^^^^^^^^^^^^^
 183 - Huge page freeing needs to be handled properly while running the application else it might
 184   cause system crash. Known issue from DPDK.
 185 - UDP Replay is used to capture throughput for dynamic cgnapt
 186 - Hardware Checksum offload is not supported for IPv6 traffic
 187 - SampleVNF on sriov is tested till 4 threads
 188 - Rest API is supported only for vACL, vFW, vCGNAPT
 189 - Rest API uses port 80, make sure other webservices are stopped before using SampleVNF RestAPI.
 190
 191 Corrected Faults
 192 ^^^^^^^^^^^^^^^^
 193
 194 Hunter 8.2:
 195
 196 +----------------------------+----------------------------------------------------------------------+
 197 | **JIRA REFERENCE**         | **DESCRIPTION**                                                      |
 198 +----------------------------+----------------------------------------------------------------------+
 199 | SAMPLEVNF-129              |  Support for DPDK 18.05 and DPDK 18.08                               |
 200 +----------------------------+----------------------------------------------------------------------+
 201 | SAMPLEVNF-130              |  Add support for counting non dataplane related packets              |
 202 +----------------------------+----------------------------------------------------------------------+
 203 | SAMPLEVNF-131              |  test improvements and fixes for image creation                      |
 204 +----------------------------+----------------------------------------------------------------------+
 205 | SAMPLEVNF-132              |  Local Documentation Builds                                          |
 206 +----------------------------+----------------------------------------------------------------------+
 207 | SAMPLEVNF-133              |  Improve l3fwd performance                                           |
 208 +----------------------------+----------------------------------------------------------------------+
 209 | SAMPLEVNF-134              |  Enable the local cache mac address                                  |
 210 +----------------------------+----------------------------------------------------------------------+
 211 | SAMPLEVNF-135              |  Initial support for DPDK 18.05                                      |
 212 +----------------------------+----------------------------------------------------------------------+
 213 | SAMPLEVNF-136              |  Adding centos.json to be used with packer to generate a VM with PROX|
 214 +----------------------------+----------------------------------------------------------------------+
 215 | SAMPLEVNF-137              |  Adding support for Ubuntu 17.20...                                  |
 216 +----------------------------+----------------------------------------------------------------------+
 217 | SAMPLEVNF-138              |  Get multiple port stats simultaneously                              |
 218 +----------------------------+----------------------------------------------------------------------+
 219 | SAMPLEVNF-139              |  Increase default mbuf size and code simplification/cleanup          |
 220 +----------------------------+----------------------------------------------------------------------+
 221 | SAMPLEVNF-140              |  update from src port in the pvt/pub handler                         |
 222 +----------------------------+----------------------------------------------------------------------+
 223
 224
 225
 226
 227 Bug Fix Jira:
 228
 229 +----------------------------+-------------------------------------------------------------------+
 230 | **JIRA REFERENCE**         | **DESCRIPTION**                                                   |
 231 +----------------------------+-------------------------------------------------------------------+
 232 | SAMPLEVNF-141              |  Fix potential crash with latency accuracy                        |
 233 +----------------------------+-------------------------------------------------------------------+
 234 | SAMPLEVNF-142              |  TempFix: vCGNAPT/vACL ipv4 perf issue                            |
 235 +----------------------------+-------------------------------------------------------------------+
 236 | SAMPLEVNF-143              |  Temp Fix for vFW perf issue                                      |
 237 +----------------------------+-------------------------------------------------------------------+
 238 | SAMPLEVNF-144              |  fix code standard in VNFs/DPPD-PROX/handle_esp.c                 |
 239 +----------------------------+-------------------------------------------------------------------+
 240 | SAMPLEVNF-145              |  Workaround DPDK net/virtio queue setup issue                     |
 241 +----------------------------+-------------------------------------------------------------------+
 242 | SAMPLEVNF-146              |  Fix potential crash when shuffling mbufs                         |
 243 +----------------------------+-------------------------------------------------------------------+
 244
 245 Hunter known restrictions/issues
 246 --------------------------------
 247 +-----------+-----------+----------------------------------------------+
 248 | Installer | Scenario  |  Issue                                       |
 249 +===========+===========+==============================================+
 250 |           |           |                                              |
 251 +-----------+-----------+----------------------------------------------+
 252
 253
 254 Open JIRA tickets
 255 -----------------
 256
 257 +----------------------------+------------------------------------------------+
 258 | **JIRA REFERENCE**         | **DESCRIPTION**                                |
 259 |                            |                                                |
 260 +----------------------------+------------------------------------------------+
 261 |                            |                                                |
 262 |                            |                                                |
 263 +----------------------------+------------------------------------------------+
 264
 265
 266 Useful links
 267 ------------
 268
 269  - wiki project page: https://wiki.opnfv.org/display/SAM
 270
 271  - wiki SampleVNF Hunter release planing page: https://wiki.opnfv.org/display/SAM/G+-+Release+SampleVNF+planning
 272
 273  - SampleVNF repo: https://git.opnfv.org/cgit/samplevnf
 274
 275  - SampleVNF IRC chanel: #opnfv-samplevnf