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 License
   8 =======
   9
  10 OPNFV release note for SampleVNF Docs
  11 are licensed under a Creative Commons Attribution 4.0 International License.
  12 You should have received a copy of the license along with this.
  13 If not, see <http://creativecommons.org/licenses/by/4.0/>.
  14 :
  15
  16 The *SampleVNFs*, the *SampleVNF test cases* are opensource software,
  17 licensed under the terms of the Apache License, Version 2.0.
  18
  19 ==========================================
  20 OPNFV Farser Release Note for SampleVNF
  21 ==========================================
  22
  23 .. toctree::
  24    :maxdepth: 2
  25
  26 .. _SampleVNF: https://wiki.opnfv.org/SAM
  27
  28 .. _Yardstick: https://wiki.opnfv.org/yardstick
  29
  30 .. _NFV-TST001: http://www.etsi.org/deliver/etsi_gs/NFV-TST/001_099/001/01.01.01_60/gs_NFV-TST001v010101p.pdf
  31
  32
  33 Abstract
  34 ========
  35
  36 This document describes the release note of SampleVNF project.
  37
  38
  39 Version History
  40 ===============
  41
  42 +----------------+--------------------+---------------------------------+
  43 | *Date*         | *Version*          | *Comment*                       |
  44 |                |                    |                                 |
  45 +----------------+--------------------+---------------------------------+
  46 | "May 25 2018"  |  6.2.0             | SampleVNF for Farser release    |
  47 |                |                    |                                 |
  48 +----------------+--------------------+---------------------------------+
  49
  50
  51 Important Notes
  52 ===============
  53
  54 The software delivered in the OPNFV SampleVNF_ Project, comprising the
  55 *SampleVNF VNFs* and performance test case are part of  OPNFV Yardstick_
  56 Project is a realization of the methodology in ETSI-ISG NFV-TST001_.
  57
  58
  59 OPNFV Farser Release
  60 ======================
  61
  62 This Farser release provides *SampleVNF* as a approx VNF repository for
  63 VNF/NFVI testing, characterization and OPNFV feature testing, automated on
  64 OPNFV platform, including:
  65
  66 * Documentation generated with Sphinx
  67
  68   * User Guide
  69
  70   * Developer Guide
  71
  72   * Release notes (this document)
  73
  74   * Results
  75
  76 * Automated SampleVNF test suit in OPNFV Yardstick_ Project
  77
  78 * SampleVNF source code
  79
  80 For Farser release, the *SampleVNF* supported:
  81
  82 +----------------+---------------------------------------------------------+-------------------+
  83 | *VNF*          |                 *Name*                                  |    *version*      |
  84 +----------------+---------------------------------------------------------+-------------------+
  85 | *CGNAPT*       | Carrier Grade Network Address and port Translation .5.0 |     v0.1.0        |
  86 +----------------+---------------------------------------------------------+-------------------+
  87 | *Prox*         | Packet pROcessing eXecution engine                      |     v0.40.0       |
  88 |                |  acts as traffic generator, L3FWD, L2FWD, BNG etc       |                   |
  89 +----------------+---------------------------------------------------------+-------------------+
  90 | *vACL*         | Access Control List                                     |     v0.1.0        |
  91 +----------------+---------------------------------------------------------+-------------------+
  92 | *vFW*          | Firewall                                                |     v0.1.0        |
  93 +----------------+---------------------------------------------------------+-------------------+
  94 | *UDP_replay*   | UDP_Replay                                              |     v0.1.0        |
  95 +----------------+---------------------------------------------------------+-------------------+
  96
  97 .. note:: Highlevel Desgin and features supported by each of the VNFs is described in Developer
  98           and user guide.
  99
 100 For Farser release, the *SampleVNF* is used for the following
 101 testing:
 102
 103 * OPNFV platform testing - generic test cases to measure the categories:
 104
 105   * NFVI Characterization:
 106
 107     * Network
 108
 109   * VNF Characterization:
 110
 111     * Network - rfc2544, rfc3511, latency, http_test etc
 112
 113
 114 The *SampleVNF* is developed in the OPNFV community, by the SampleVNF_ team.
 115 The *Network Service Benchmarking* SampleVNF Characterization Testing tool is a part of the
 116 Yardstick Project.
 117
 118 .. note:: The test case description template used for the SampleVNF in yardstick
 119   test cases is based on the document ETSI-ISG NFV-TST001_; the results report template
 120   used for the SampleVNF test results is based on the IEEE Std 829-2008.
 121
 122
 123 Release Data
 124 ============
 125
 126 +--------------------------------------+--------------------------------------+
 127 | **Project**                          | SampleVNF                            |
 128 |                                      |                                      |
 129 +--------------------------------------+--------------------------------------+
 130 | **Repo/tag**                         | opnfv-6.2.0                          |
 131 |                                      |                                      |
 132 +--------------------------------------+--------------------------------------+
 133 | **SampleVNF Docker image tag**       | Farser 6.2                           |
 134 |                                      |                                      |
 135 +--------------------------------------+--------------------------------------+
 136 | **Release designation**              | Farser 6.2                           |
 137 |                                      |                                      |
 138 +--------------------------------------+--------------------------------------+
 139 | **Release date**                     | "May 25 2018"                        |
 140 |                                      |                                      |
 141 +--------------------------------------+--------------------------------------+
 142 | **Purpose of the delivery**          | Fraser alignment to Released         |
 143 |                                      | bug-fixes for the following:         |
 144 |                                      | - Memory leak                        |
 145 |                                      | - minimum latency                    |
 146 |                                      | - Increase default mbuf size and     |
 147 |                                      |   code simplification/cleanup        |
 148 |                                      | - Crash in rx/tx distribution        |
 149 |                                      |                                      |
 150 +--------------------------------------+--------------------------------------+
 151
 152
 153 Deliverables
 154 ============
 155
 156 Documents
 157 ---------
 158
 159  - User Guide: http://artifacts.opnfv.org/samplevnf/docs/testing_user_userguide/index.html
 160
 161  - Developer Guide: http://artifacts.opnfv.org/samplevnf/docs/testing_developer/index.html
 162
 163
 164 Software Deliverables
 165 ---------------------
 166
 167  - The SampleVNF Docker image: To be added
 168
 169
 170 **SampleVNF tested on Contexts**
 171
 172 +---------------------+-------------------------------------------------------+
 173 | **Context**         | **Description**                                       |
 174 |                     |                                                       |
 175 +---------------------+-------------------------------------------------------+
 176 | *Heat*              | Models orchestration using OpenStack Heat             |
 177 |                     |                                                       |
 178 +---------------------+-------------------------------------------------------+
 179 | *Node*              | Models Baremetal, Controller, Compute                 |
 180 |                     |                                                       |
 181 +---------------------+-------------------------------------------------------+
 182 | *Standalone*        | Models VM running on Non-Managed NFVi                 |
 183 |                     |                                                       |
 184 +---------------------+-------------------------------------------------------+
 185
 186 Document Version Changes
 187 ------------------------
 188
 189 This is the first version of the SampleVNF  in OPNFV.
 190 It includes the following documentation updates:
 191
 192 - SampleVNF User Guide:
 193
 194 - SampleVNF Developer Guide
 195
 196 - SampleVNF Release Notes for SampleVNF: this document
 197
 198
 199 Feature additions
 200 -----------------
 201
 202 - SampleVNF RESTful API support
 203 - Security gateway testing
 204 - Support reading inline jumbo frame and dump them
 205 - Add support for generation of jumbo frames
 206 - Support for dpdk-stable-17.11.1 crypto
 207 - Add support for multiple variables in core definition
 208 - Support async operation in handle_esp
 209 - Add support for reception of jumbo frames
 210 - Support additional MAC format in config file
 211 - Add support for multiple GEN tasks running on the same core
 212 - Add support for crypto on multiple cores
 213 - Zero packet loss testing has been added.
 214 - Integrate irq mode into PROX (support display and command line)
 215 - Support async operation in handle_esp
 216 - Add config option to use port mac as src mac in l2fwd and swap
 217 - Add support for DPDK 17.11
 218 - Add support for multiple tasks generating to same ip in l3 mode.
 219 - Add l3 support for tasks without physical tx ports
 220
 221 Bug fixes:
 222 - link speed when link is down at startup.
 223 - minimum latency
 224 - potential crash if link speed is null
 225 - the calculation of dropped packets and other changes
 226 - latency accuracy and dumping latencies to file
 227 - issues with the pkt_size command
 228 - potential crash in rx and tx distribution
 229 - extrapolation used in latency measurements
 230 - dumping receive packets
 231 - using signature in latency measurements
 232 - stacking of rx receive functions
 233 - potential crash when issuing "tx distr stop" command.
 234 - extrapolation used in latency measurements
 235 - memory leak introduced by 4a65cd84
 236
 237
 238 Known Issues/Faults
 239 -------------------
 240 - Huge page freeing needs to be handled properly while running the application else it might
 241   cause system crash. Known issue from DPDK.
 242 - UDP Replay is used to capture throughput for dynamic cgnapt
 243 - Hardware Checksum offload is not supported for IPv6 traffic
 244 - SampleVNF on sriov is tested till 4 threads
 245 - Rest API is supported only for vACL, vFW, vCGNAPT
 246 - Rest API uses port 80, make sure other webservices are stopped before using SampleVNF RestAPI.
 247
 248 Corrected Faults
 249 ----------------
 250
 251 Farser 6.2:
 252
 253 +----------------------------+-------------------------------------------------------------------+
 254 | **JIRA REFERENCE**         | **DESCRIPTION**                                                   |
 255 +----------------------------+-------------------------------------------------------------------+
 256 | SAMPLEVNF-98               |  SampleVNF RESTful API support                                    |
 257 +----------------------------+-------------------------------------------------------------------+
 258 | SAMPLEVNF-99               |  Security gateway testing                                         |
 259 +----------------------------+-------------------------------------------------------------------+
 260 | SAMPLEVNF-100              |  Add support for generation of jumbo frames                       |
 261 +----------------------------+-------------------------------------------------------------------+
 262 | SAMPLEVNF-101              |  Support for dpdk-stable-17.11.1 crypto                           |
 263 +----------------------------+-------------------------------------------------------------------+
 264 | SAMPLEVNF-102              |  Support async operation in handle_espo                           |
 265 +----------------------------+-------------------------------------------------------------------+
 266 | SAMPLEVNF-103              |  Add support for reception of jumbo frames                        |
 267 +----------------------------+-------------------------------------------------------------------+
 268 | SAMPLEVNF-104              |  Support additional MAC format in config file                     |
 269 +----------------------------+-------------------------------------------------------------------+
 270 | SAMPLEVNF-105              |  support for multiple GEN tasks running on the same core          |
 271 +----------------------------+-------------------------------------------------------------------+
 272 | SAMPLEVNF-106              |  Add support for crypto on multiple cores                         |
 273 +----------------------------+-------------------------------------------------------------------+
 274 | SAMPLEVNF-107              |  Zero packet loss testing                                         |
 275 +----------------------------+-------------------------------------------------------------------+
 276 | SAMPLEVNF-108              |  Integrate irq mode into PROX (support display and command line)  |
 277 +----------------------------+-------------------------------------------------------------------+
 278 | SAMPLEVNF-109              |  Add config option to use port mac as src mac in l2fwd and swap   |
 279 +----------------------------+-------------------------------------------------------------------+
 280 | SAMPLEVNF-110              |  Add support for DPDK 17.11                                       |
 281 +----------------------------+-------------------------------------------------------------------+
 282 | SAMPLEVNF-111              |  Add support for multiple tasks generating to same ip in l3 mode  |
 283 +----------------------------+-------------------------------------------------------------------+
 284 | SAMPLEVNF-112              |  Add l3 support for tasks without physical tx ports               |
 285 +----------------------------+-------------------------------------------------------------------+
 286
 287 Bug Fix Jira:
 288
 289 +----------------------------+-------------------------------------------------------------------+
 290 | **JIRA REFERENCE**         | **DESCRIPTION**                                                   |
 291 +----------------------------+-------------------------------------------------------------------+
 292 | SAMPLEVNF-113              |  link speed when link is down at startup.                         |
 293 +----------------------------+-------------------------------------------------------------------+
 294 | SAMPLEVNF-114              |  minimum latency                                                  |
 295 +----------------------------+-------------------------------------------------------------------+
 296 | SAMPLEVNF-115              |  potential crash if link speed is null                            |
 297 +----------------------------+-------------------------------------------------------------------+
 298 | SAMPLEVNF-116              |  the calculation of dropped packets and other changes             |
 299 +----------------------------+-------------------------------------------------------------------+
 300 | SAMPLEVNF-117              |  latency accuracy and dumping latencies to file                   |
 301 +----------------------------+-------------------------------------------------------------------+
 302 | SAMPLEVNF-118              |  issues with the pkt_size command                                 |
 303 +----------------------------+-------------------------------------------------------------------+
 304 | SAMPLEVNF-119              |  extrapolation used in latency measurements                       |
 305 +----------------------------+-------------------------------------------------------------------+
 306 | SAMPLEVNF-120              |  dumping receive packets                                          |
 307 +----------------------------+-------------------------------------------------------------------+
 308 | SAMPLEVNF-121              |  using signature in latency measurements                          |
 309 +----------------------------+-------------------------------------------------------------------+
 310 | SAMPLEVNF-122              |  stacking of rx receive functions                                 |
 311 +----------------------------+-------------------------------------------------------------------+
 312 | SAMPLEVNF-123              |  potential crash when issuing "tx distr stop" command.            |
 313 +----------------------------+-------------------------------------------------------------------+
 314 | SAMPLEVNF-124              |  extrapolation used in latency measurements                       |
 315 +----------------------------+-------------------------------------------------------------------+
 316 | SAMPLEVNF-125              |  memory leak introduced by 4a65cd84                               |
 317 +----------------------------+-------------------------------------------------------------------+
 318
 319 Farser known restrictions/issues
 320 ====================================
 321 +-----------+-----------+----------------------------------------------+
 322 | Installer | Scenario  |  Issue                                       |
 323 +===========+===========+==============================================+
 324 |           |           |                                              |
 325 +-----------+-----------+----------------------------------------------+
 326
 327
 328 Open JIRA tickets
 329 =================
 330
 331 +----------------------------+------------------------------------------------+
 332 | **JIRA REFERENCE**         | **DESCRIPTION**                                |
 333 |                            |                                                |
 334 +----------------------------+------------------------------------------------+
 335 |                            |                                                |
 336 |                            |                                                |
 337 +----------------------------+------------------------------------------------+
 338
 339
 340 Useful links
 341 ============
 342
 343  - wiki project page: https://wiki.opnfv.org/display/SAM
 344
 345  - wiki SampleVNF Farser release planing page: https://wiki.opnfv.org/display/SAM/F+Release+Plan+for+SampleVNF
 346
 347  - SampleVNF repo: https://git.opnfv.org/cgit/samplevnf
 348
 349  - SampleVNF IRC chanel: #opnfv-samplevnf