From 65df9717730bd34e10f5f231f6869792ecab6e92 Mon Sep 17 00:00:00 2001 From: Gwenael Lambrouin Date: Mon, 14 Nov 2022 17:56:10 +0100 Subject: [PATCH] nfvbenchvm: release 0.16 - separate loop VM and generator VM version numbers (a first step towards using nfvbench version number for the generator VM) - increase loop VM version number - Add a release note page dedicated to nfvbench loop VM Signed-off-by: Gwenael Lambrouin Change-Id: I2bc651eb315bfa889e5dd1d56f69e2c3d9219646 --- docs/development/building/build.rst | 2 + docs/release/release-notes/index.rst | 1 + .../release-notes/nfvbenchvm-release-notes.rst | 94 ++++++++++++++++++++++ docs/release/release-notes/release-notes.rst | 13 +-- nfvbenchvm/dib/build-image.sh | 7 +- 5 files changed, 108 insertions(+), 9 deletions(-) create mode 100644 docs/release/release-notes/nfvbenchvm-release-notes.rst diff --git a/docs/development/building/build.rst b/docs/development/building/build.rst index 00c1c98..aeda059 100644 --- a/docs/development/building/build.rst +++ b/docs/development/building/build.rst @@ -14,6 +14,8 @@ This container includes the following parts: - NFVbench orchestration - NFVbench test VM (qcow2) +.. _nfvbench-artefact-versioning: + Versioning ---------- These 3 parts are versioned independently and the Dockerfile will determine the combination of versions that diff --git a/docs/release/release-notes/index.rst b/docs/release/release-notes/index.rst index 12acbab..5f3f9f6 100644 --- a/docs/release/release-notes/index.rst +++ b/docs/release/release-notes/index.rst @@ -11,3 +11,4 @@ NFVbench Release Notes :maxdepth: 1 release-notes + nfvbenchvm-release-notes diff --git a/docs/release/release-notes/nfvbenchvm-release-notes.rst b/docs/release/release-notes/nfvbenchvm-release-notes.rst new file mode 100644 index 0000000..234a086 --- /dev/null +++ b/docs/release/release-notes/nfvbenchvm-release-notes.rst @@ -0,0 +1,94 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + + +NFVbench Loop VM Image Release Notes +++++++++++++++++++++++++++++++++++++ + +As explained in :ref:`nfvbench-artefact-versioning`, NFVbench loop VM image has +its own version numbering scheme. Starting from version 0.11, this page +summarizes the news of each release. + + +Release 0.16 (2022-11-15) +========================= + +Fixes: + +- Increase wait for VPP service from 10 to 30 seconds (10s is not enough on some + setups) and poll every second instead of sleeping 10s. + +- Set the MTU of the management interface to 1500 by default (to reduce the risk + to get an unmanageable VM). A different value can be set using the + ``INTF_MGMT_MTU`` variable in ``/etc/nfvbenchvm.conf``. + +Changes for developers: + +- Add 2 debug features to ``build-image.sh``: + + - The new option ``-t`` (enable debug traces) allows to show in the build log + the commands run in the shell scripts, including the commands defined in the + disk image builder elements. + + - The new option ``-d`` (debug) instructs ``disk-image-create`` to drop the + developer in a shell inside the chroot in case an error occurs. This makes + troubleshooting of the image possible (inspect files, run commands, ...) + +- Abort build on error: make sure a VM image build fails if any step fails. + Else we can end up with a bad image not containing all that we want, and we + discover this later at run time. + +- Fix build with diskimage_builder (dib) 3.16.0. + +- Switch VPP package repository to packagecloud.io instead of nexus.fd.io. This + fixes intermittent access issues with nexus.fd.io and this will make it + possible to get vpp releases higher than 19.08. + +- Separate loop VM and generator VM version numbers (a first step towards using + nfvbench version number for the generator VM). + + +Release 0.15 (2021-06-04) +========================= + +- NFVBENCH-211 Fix VPP driver for loop VM (switch UIO driver for VPP forwarder: + use ``uio_pci_generic`` instead of ``igb_uio``). + + +Release 0.14 (2021-05-21) +========================= + +- NFVBENCH-209 Fix NFVbench loopvm build failed on testpmd step (includes switch + UIO driver for testmpd forwarder: use ``uio_pci_generic`` instead of + ``igb_uio``). + + +Release 0.13 (2021-04-28) +========================= + +- NFVBENCH-196: New NFVbench image for generator part (nfvbench and TRex codes inside VM) +- Change Linux kernel boot-time configuration (kernel CLI parameters): + + - Extend CPU isolation (``isolcpus=1-7`` instead of ``isolcpus=1``) + - Increase the number of 1GB huge pages (``hugepages=4`` instead of ``hugepages=2``) + - Enable IOMMU (``intel_iommu=on iommu=pt``) + +- Load the ``vfio-pci`` kernel module with the ``enable_unsafe_noiommu_mode=1`` option. + + +Release 0.12 (2020-01-23) +========================= + +- NFVBENCH-157 Add possibility to not use the ARP static configuration for VPP loop VM + + +Release 0.11 (2019-11-26) +========================= + +- NFVBENCH-156 Add management interface and ssh config in NFVBench image + + +Earlier releases +================ + +See NFVbench commit history. diff --git a/docs/release/release-notes/release-notes.rst b/docs/release/release-notes/release-notes.rst index b9f6cdd..cbb44c5 100644 --- a/docs/release/release-notes/release-notes.rst +++ b/docs/release/release-notes/release-notes.rst @@ -7,12 +7,13 @@ RELEASE NOTES Release 3.6.2 ============= -NFVBENCH-152 Add service_mode method for debugging purpose -NFVBENCH-150 Add support for VXLAN latency -NFVBENCH-146 Add cache_size option -NFVBENCH-151 Allocate hugepages on two NUMAs in nfvbenchvm -NFVBENCH-149 Negative latency exception during NDR/PDR search -NFVBENCH-148 Increase the waiting time based on # of instances + +- NFVBENCH-152 Add service_mode method for debugging purpose +- NFVBENCH-150 Add support for VXLAN latency +- NFVBENCH-146 Add cache_size option +- NFVBENCH-151 Allocate hugepages on two NUMAs in nfvbenchvm +- NFVBENCH-149 Negative latency exception during NDR/PDR search +- NFVBENCH-148 Increase the waiting time based on # of instances Release 3.5.1 ============= diff --git a/nfvbenchvm/dib/build-image.sh b/nfvbenchvm/dib/build-image.sh index 8ee9bf3..c5d24da 100755 --- a/nfvbenchvm/dib/build-image.sh +++ b/nfvbenchvm/dib/build-image.sh @@ -19,9 +19,10 @@ __prefix__="" gs_url=artifacts.opnfv.org/nfvbench/images # image version number -__version__=0.15 -loopvm_image_name=nfvbenchvm_centos-$__version__ -generator_image_name=nfvbenchvm_centos-generator-$__version__ +__loopvm_version__=0.16 +__generator_version__=0.15 +loopvm_image_name=nfvbenchvm_centos-$__loopvm_version__ +generator_image_name=nfvbenchvm_centos-generator-$__generator_version__ # Default values for nfvbenchvm dib element variables export DIB_NFVBENCH_CODE_ORIGIN=opnfv-gerrit -- 2.16.6