1.1. License

OPNFV release note for SampleVNF Docs are licensed under a Creative Commons Attribution 4.0 International License. You should have received a copy of the license along with this. If not, see <http://creativecommons.org/licenses/by/4.0/>. :

The SampleVNFs, the SampleVNF test cases are opensource software, licensed under the terms of the Apache License, Version 2.0.

1.2. OPNFV Hunter Release Note for SampleVNF

1.2.1. Abstract

This document describes the release note of SampleVNF project.

1.2.2. Version History

1.2.3. Important Notes

The software delivered in the OPNFV SampleVNF Project, comprising the SampleVNF VNFs and performance test case are part of OPNFV Yardstick Project is a realization of the methodology in ETSI-ISG NFV-TST001.

1.2.4. OPNFV Hunter Release

This Hunter release provides SampleVNF as a approx VNF repository for VNF/NFVI testing, characterization and OPNFV feature testing, automated on OPNFV platform, including:

  • Documentation generated with Sphinx
    • User Guide
    • Developer Guide
    • Release notes (this document)
    • Results
  • Automated SampleVNF test suit in OPNFV Yardstick Project
  • SampleVNF source code

For Hunter release, the SampleVNF supported:

VNF Name version
CGNAPT Carrier Grade Network Address and port Translation .5.0 v0.1.0
Prox
Packet pROcessing eXecution engine
acts as traffic generator, L3FWD, L2FWD, BNG etc
 v0.40.0
vACL Access Control List v0.1.0
vFW Firewall v0.1.0
UDP_replay UDP_Replay v0.1.0

Note

Highlevel Desgin and features supported by each of the VNFs is described in Developer and user guide.

For Hunter release, the SampleVNF is used for the following testing:

  • OPNFV platform testing - generic test cases to measure the categories:
    • NFVI Characterization:
      • Network
    • VNF Characterization:
      • Network - rfc2544, rfc3511, latency, http_test etc

The SampleVNF is developed in the OPNFV community, by the SampleVNF team. The Network Service Benchmarking SampleVNF Characterization Testing tool is a part of the Yardstick Project.

Note

The test case description template used for the SampleVNF in yardstick test cases is based on the document ETSI-ISG NFV-TST001; the results report template used for the SampleVNF test results is based on the IEEE Std 829-2008.

1.2.5. Release Data

Project SampleVNF
Repo/tag opnfv-8.0
SampleVNF Docker image tag Hunter 8.0
Release designation Hunter 8.0
Release date “May 10 2019”
Purpose of the delivery

Hunter alignment to Released bug-fixes for the following: - Memory leak - minimum latency - Increase default mbuf size and

code simplification/cleanup
  • Crash in rx/tx distribution

1.2.6. Deliverables

1.2.6.2. Software Deliverables

  • The SampleVNF Docker image: To be added

SampleVNF tested on Contexts

Context Description
Heat Models orchestration using OpenStack Heat
Node Models Baremetal, Controller, Compute
Standalone Models VM running on Non-Managed NFVi

1.2.6.3. Document Version Changes

This is the first version of the SampleVNF in OPNFV. It includes the following documentation updates:

  • SampleVNF User Guide:
  • SampleVNF Developer Guide
  • SampleVNF Release Notes for SampleVNF: this document

1.2.6.4. Feature additions

  • Support for DPDK 18.05 and DPDK 18.08
  • Add support for counting non dataplane related packets
  • test improvements and fixes for image creation
  • Local Documentation Builds
  • Improve l3fwd performance
  • Enable the local cache mac address
  • Initial support for DPDK 18.05
  • Adding centos.json to be used with packer to generate a VM with PROX
  • Adding support for Ubuntu 17.10…
  • Get multiple port stats simultaneously
  • Increase default mbuf size and code simplification/cleanup
  • update from src port in the pvt/pub handler

Bug fixes: - Fix potential crash with latency accuracy - TempFix: vCGNAPT/vACL ipv4 perf issue - Temp Fix for vFW perf issue - fix code standard in VNFs/DPPD-PROX/handle_esp.c - Workaround DPDK net/virtio queue setup issue - Fix potential crash when shuffling mbufs

1.2.6.5. Known Issues/Faults

  • Huge page freeing needs to be handled properly while running the application else it might cause system crash. Known issue from DPDK.
  • UDP Replay is used to capture throughput for dynamic cgnapt
  • Hardware Checksum offload is not supported for IPv6 traffic
  • SampleVNF on sriov is tested till 4 threads
  • Rest API is supported only for vACL, vFW, vCGNAPT
  • Rest API uses port 80, make sure other webservices are stopped before using SampleVNF RestAPI.

1.2.6.6. Corrected Faults

Hunter 8.2:

Bug Fix Jira:

JIRA REFERENCE DESCRIPTION
SAMPLEVNF-141 Fix potential crash with latency accuracy
SAMPLEVNF-142 TempFix: vCGNAPT/vACL ipv4 perf issue
SAMPLEVNF-143 Temp Fix for vFW perf issue
SAMPLEVNF-144 fix code standard in VNFs/DPPD-PROX/handle_esp.c
SAMPLEVNF-145 Workaround DPDK net/virtio queue setup issue
SAMPLEVNF-146 Fix potential crash when shuffling mbufs

1.2.7. Hunter known restrictions/issues

Installer Scenario Issue
     

1.2.8. Open JIRA tickets

JIRA REFERENCE DESCRIPTION
   

1.2.10. Hunter known restrictions/issues

Installer Scenario Issue
     

1.2.11. Open JIRA tickets

JIRA REFERENCE DESCRIPTION
   

1.2.12. Useful links

Bug Fix Jira:

1.2.13. Hunter known restrictions/issues

Installer Scenario Issue
     

1.2.14. Open JIRA tickets

JIRA REFERENCE DESCRIPTION
   

1.2.15. Useful links

Bug Fix Jira:

1.2.16. Hunter known restrictions/issues

Installer Scenario Issue
     

1.2.17. Open JIRA tickets

JIRA REFERENCE DESCRIPTION
   

1.2.18. Useful links

Bug Fix Jira:

1.2.19. Hunter known restrictions/issues

Installer Scenario Issue
     

1.2.20. Open JIRA tickets

JIRA REFERENCE DESCRIPTION
   

1.2.21. Useful links

Bug Fix Jira:

1.2.22. Hunter known restrictions/issues

Installer Scenario Issue
     

1.2.23. Open JIRA tickets

JIRA REFERENCE DESCRIPTION
   

1.2.24. Useful links

Bug Fix Jira:

1.2.25. Hunter known restrictions/issues

Installer Scenario Issue
     

1.2.26. Open JIRA tickets

JIRA REFERENCE DESCRIPTION
   

1.2.27. Useful links