RELEASE.md

   1 # Release Notes    {#release_notes}
   2
   3 * @subpage release_notes_1704
   4 * @subpage release_notes_1701
   5 * @subpage release_notes_1609
   6 * @subpage release_notes_1606
   7
   8 @page release_notes_1704 Release notes for VPP 17.04
   9
  10 ## API changes
  11
  12 - Python API: To avoid conflicts between VPP API messages names and
  13   the Python API binding function names, VPP API methods are put in a
  14   separate proxy object.
  15   https://gerrit.fd.io/r/#/c/5570/
  16   The api methods are now referenced as:
  17     vpp_handle = VPP(jsonfiles)
  18     vpp_handle.connect(...)
  19     vpp = vpp_handle.api
  20     vpp.show_version()
  21     vpp_handle.disconnect()
  22
  23   For backwards compatibility VPP API methods are left in the main
  24   name space (VPP), but will be removed from 17.07.
  25
  26 - create_loopback message to be replaced with create_loopback_instance
  27   create_loopback will be removed from 17.07.
  28   https://gerrit.fd.io/r/#/c/5572/
  29
  30 @todo Release 17.04 needs release notes.
  31
  32 @page release_notes_1701 Release notes for VPP 17.01
  33
  34 @note This release was for a while known as 16.12.
  35 @todo Release 17.01 needs release notes. It will show up here soon...
  36
  37 ## Features
  38
  39 ## Known issues
  40
  41 ## Issues fixed
  42
  43
  44 @page release_notes_1609 Release notes for VPP 16.09
  45
  46 ## Features
  47
  48 - [Integrated July 2016 DPDK release](http://www.dpdk.org/doc/guides/rel_notes/release_16_07.html)
  49   - DPDK-vhost is depreciated pending a complete rework of the original integration and
  50     addressing of rx performance deltas.
  51   - Patches required for DPDK 16.07:
  52     - Correctly setting the Packet Type in the IGB, IXGBE and i40e drivers.
  53     - Correctly setting checksum in the i40e driver.
  54     - NXP DPAA2 PMD Driver.
  55     - rte_delay (yield) functionality.
  56
  57 - Add “in tree” plugins:
  58   - IPv6 ILA.
  59   - iOAM.
  60   - Load Balancer.
  61   - SNAT.
  62
  63 - High-performance (line-rate) “neutron like” L4 port-filtering.
  64
  65 - API refactoring - addressing some of the issues around JVPP bindings.
  66   - Accommodating plugins [(e.g. NSH_SFC)](https://wiki.fd.io/view/NSH_SFC)
  67   - Binding for [python](https://wiki.fd.io/view/VPP/Python_API)
  68
  69 - LISP
  70   - L2 LISP overlays
  71   -  Multitenancy
  72   - Multihoming
  73   - RTR mode
  74   - Map-resolver failover algorithm
  75
  76 - Support 64-bit vector lengths, huge shared-memory segments.
  77
  78 - Dynamic IP Feature ordering
  79   - IP Features can now specify features they appear before and after
  80
  81 - 16.09 Builds
  82   - Ubuntu 14.04 LTS - Trusty Tahr
  83   - Ubuntu 16.04 LTS - Xenial Xerus
  84   - CentOS 7
  85   - More information on [VPP wiki](https://wiki.fd.io/view/VPP/Installing_VPP_binaries_from_packages)
  86
  87 - Performance, characterize and document performance for this release
  88   [(more information on CSIT page)](https://wiki.fd.io/view/CSIT)
  89
  90    - IPv4 and IPv6 Scale - performance tests.
  91      - Bidirectional 10k/100k/1M flows.
  92      - 64B,570B, 1518B,9000B packet sizes.
  93    - IPv6 iACL - performance
  94      - DUT1 and DUT2 are configured with IPv6 routing, two static IPv6 /64 routes and IPv6 iAcl
  95        security whitelist ingress /64 filter entries applied on links.
  96      - TG traffic profile contains two L3 flow-groups (flow-group per direction, 253 flows per
  97        flow-group) with all packets containing Ethernet header, IPv6 header and generated payload.
  98        MAC addresses are matching MAC addresses of the TG node interfaces.
  99
 100    - L2XC VXLANoIPv4 - performance
 101      - DUT1 and DUT2 are configured with L2 cross-connect. VXLAN tunnels are configured between
 102        L2XCs on DUT1 and DUT2.
 103      - TG traffic profile contains two L3 flow-groups (flow-group per direction, 253 flows per
 104        flow-group) with all packets containing Ethernet header, IPv4 header with IP protocol=61
 105        and generated payload. MAC addresses are matching MAC addresses of the TG node interfaces.
 106
 107 - Documentation
 108   - Autogenerated CLI documentation.
 109   - Using doxygen to automate API/Node documentation.
 110   - [(available online)](https://docs.fd.io/vpp/16.09/)
 111
 112 - Resolved all static analysis issues found by Coverity
 113   - Beginning of 16.09 cycle: 505 issues.
 114   - Release: 0 outstanding issues.
 115
 116
 117 ## Known issues
 118
 119 Issues in fd.io are tracked in [JIRA](https://jira.fd.io).
 120
 121 Issue | Description
 122 --- | ---
 123 VPP-391 |   vpp debug version assert appeared in the process of start
 124 VPP-380 |   Mapping algorithm compute wrong ea-bits when IPv4 prefix 0.0.0.0/0
 125 VPP-371 |   load_one_plugin:63: Loaded plugin: message from vppctl
 126 VPP-367 |   vpp packages need to depend on specific versions of each other
 127 VPP-312 |   IP6 FIB gets in indeterminate state by duplicating commands
 128 VPP-224 |   Lookup-in-vrf can not be set correctly
 129 VPP-206 |   Fix classify table delete
 130 VPP-203 |   Fix binary API for reading vpp node graph
 131 VPP-147 |   Inconsistent behaviour when adding L2 FIB filter entry
 132 VPP-99  |  VPP doesn't discard DHCPOFFER message with wrong XID
 133
 134
 135 ## Issues fixed
 136
 137 Issues in fd.io are tracked in [JIRA](https://jira.fd.io).
 138
 139 Issue | Description
 140 --- | ---
 141 VPP-396 |   Ubuntu systems Graphviz bug
 142 VPP-390 |   vpp-lib rpm fails to include *.so symlinks, causing linking problems with out of tree builds
 143 VPP-388 |   IPSec output feature assumes packets have been ethernet rewritten
 144 VPP-385 |   ARP for indirect adjacencies not working correctly
 145 VPP-361 |   Memory leak on delete of VXLAN over IPv6 tunnel
 146 VPP-357 |   VNI not set correctly when removing LISP fwd entries
 147 VPP-349 |   sw_interface_vhost_user_dump not working
 148 VPP-345 |   net/enic: bad L4 checksum ptype set on ICMP packets
 149 VPP-340 |   MAP-T wrong destination address
 150 VPP-330 |   Use fifo to store LISP pending map-requests
 151 VPP-326 |   map_add_domain VAT command: unable to configure domain with mtu parameter
 152 VPP-318 |   The map_add_domain VAT command accepts invalid arguments
 153 VPP-315 |   Fix "show vxlan-gpe" issue
 154 VPP-310 |   Mapping algorithm compute wrong ea-bits
 155 VPP-239 |   LISP IP forwarding does not tag packets that hit negative mapping entries
 156 VPP-235 |   Invalid help in VAT for sw_interface_set_l2_bridge
 157 VPP-228 |   Mapping algorithm sends packet to wrong IPv6 address
 158 VPP-214 |   vpp-api-test: api_ipsec_sad_add_del_entry: vector "ck" not initialized
 159 VPP-200 |   VPP - TAP port create problem
 160 VPP-189 |   Coverity Issues for 16.09
 161 VPP-184 |   u16 translating to char ,not short
 162 VPP-179 |   Adjacency share-count botch
 163 VPP-163 |   "show ip6 interface" ignores non-global addresses
 164 VPP-155 |   Netmap: Inconsistency in interface state between "show hardware" and "show interface"
 165 VPP-145 |   Dynamically compute IP feature ordering based on constraints
 166 VPP-137 |   VPP sends ARP with wrong requested IP
 167 VPP-118 |   JVpp: 0 length arrays not handled properly in VPP responses
 168 VPP-112 |   linux kernel info missing from build log
 169 VPP-110 |   vxlan encap node should never touch a deleted tunnel
 170 VPP-107 |   RPM build broken in master
 171 VPP-92  |   segment routing is not properly filling out the segment list
 172 VPP-91  |   segment routing add/del tunnel lookup doesn't work
 173 VPP-84  |   af_packet throws a fatal error on EAGAIN
 174 VPP-74  |   Clang compile fails due to warning in vlib/unix/cli.c
 175 VPP-64  |   Top level "make pkg-deb" fails if CDPATH is set in user env.
 176 VPP-48  |   Traceroute does not terminate when VPP is the target
 177 VPP-23  |   CLI pager does not gracefully handle lines longer than the terminal width
 178
 179
 180 @page release_notes_1606 Release notes for VPP 16.06
 181
 182
 183 The FD.io Project, relentlessly focused on data IO speed and efficiency
 184 supporting the creation of high performance, flexible, and scalable software
 185 defined infrastructures, announces the availability of the community’s first
 186 software release (16.06).
 187
 188 In the four months since launching, FD.io has brought together more than 75
 189 developers from 11 different companies including network operators, solution
 190 providers chip vendors, and network equipment vendors who are collaborating to
 191 enhance and innovate around the Vector Packet Processing (VPP) technology. The
 192 FD.io community has quickly formed to grow the number of projects from the
 193 initial VPP project to an additional 6 projects addressing a diverse set of
 194 requirements and usability across a variety of deployment environments.
 195
 196 The 16.06 release brings unprecedented performance: 480Gbps/200mpps with 8
 197 million routes and 2k whitelist entries on standard high volume x86 servers.
 198
 199
 200 ## Features
 201
 202 In addition to the existing full suite of vswitch/vrouter features, the new
 203 16.06 release adds:
 204
 205 * Enhanced Switching and Routing:
 206   * IPv6 Segment Routing multicast support.
 207   * LISP xTR support.
 208   * VXLAN over IPv6 underlay.
 209   * Per interface whitelists.
 210   * Shared adjacencies in FIB.
 211
 212 * New and improved interface support:
 213   * Jumbo frame support for vhost-user.
 214   * Netmap interface support.
 215   * AF_Packet interface support.
 216
 217 * Expanded and improved programmability:
 218   * Python API bindings.
 219   * Enhanced JVPP Java API bindings.
 220   * Debugging CLI.
 221
 222 * Expanded Hardware and Software Support:
 223   * Support for ARM 32 targets including Rasberry Pi single-board computer.
 224   * Support for DPDK 16.04.
 225