1 # Release Notes {#release_notes}
3 * @subpage release_notes_1802
4 * @subpage release_notes_1710
5 * @subpage release_notes_1707
6 * @subpage release_notes_1704
7 * @subpage release_notes_17011
8 * @subpage release_notes_1701
9 * @subpage release_notes_1609
10 * @subpage release_notes_1606
12 @page release_notes_1802 Release notes for VPP 18.02
16 @page release_notes_1710 Release notes for VPP 17.10
18 More than 400 commits since the 1707 release.
24 - Bounded-index extensible hash bucket-level LRU cache
25 - Templated timer wheel improvements
28 - C/C++ language binding
32 - VPP TCP stack scale/congestion improvements
33 - VPP Comms Library (VCL)
34 - Overall performance, scale and hardening
37 - IPSec rework - utilize new FIB
38 - VPLS and VPWS implementation
43 - Destination NAT44 with load-balancing
44 - In2out translation as an output feature on the outside interface
45 - Fullback to 3-tuple key for non TCP/UDP/ICMP sessions
47 - Security Groups/ACLs
48 - "Replace" semantics for adding a new MacIP acl
49 - Test suite tests for MacIP ACLs
52 - Map-server fallback support
53 - Preemptive re-fetch of active mappings that are about to expire
57 - PPPoE Control Plane packet dispatch
63 For the full list of issues please refer to fd.io [JIRA](https://jira.fd.io).
67 For the full list of fixed issues please refer to:
68 - fd.io [JIRA](https://jira.fd.io)
69 - git [commit log](https://git.fd.io/vpp/log/?h=stable/1710)
74 bridge_domain_add_del definition changed
75 bridge_domain_details definition changed
76 connect_session definition changed
77 connect_sock definition changed
78 connect_sock_reply definition changed
79 connect_uri_reply definition changed
80 create_vhost_user_if definition changed
81 dhcp_client_config definition changed
82 ip4_arp_event definition changed
83 ip6_fib_details definition changed
84 ip6_nd_event definition changed
85 ip_add_del_route definition changed
86 ip_fib_details definition changed
87 ip_table_add_del definition changed
88 l2_macs_event only in image
89 macip_acl_add_replace definition changed
90 macip_acl_interface_list_details only in image
91 macip_acl_interface_list_dump only in image
92 modify_vhost_user_if definition changed
93 mpls_fib_details definition changed
94 mpls_route_add_del definition changed
95 mpls_table_add_del definition changed
96 mpls_tunnel_add_del definition changed
97 nat44_add_del_address_range definition changed
98 nat44_add_del_interface_addr definition changed
99 nat44_add_del_lb_static_mapping definition changed
100 nat44_add_del_static_mapping definition changed
101 nat44_address_details only in image
102 nat44_address_dump only in image
103 nat44_interface_add_del_feature definition changed
104 nat44_interface_add_del_output_feature definition changed
105 nat44_interface_addr_details only in image
106 nat44_interface_addr_dump only in image
107 nat44_interface_details only in image
108 nat44_interface_dump only in image
109 nat44_interface_output_feature_details only in image
110 nat44_interface_output_feature_dump only in image
111 nat44_lb_static_mapping_details only in image
112 nat44_lb_static_mapping_dump only in image
113 nat44_static_mapping_details only in image
114 nat44_static_mapping_dump only in image
115 nat44_user_details only in image
116 nat44_user_dump only in image
117 nat44_user_session_details only in image
118 nat44_user_session_dump only in image
119 nat_control_ping definition changed
120 nat_det_add_del_map definition changed
121 nat_det_close_session_in definition changed
122 nat_det_close_session_out definition changed
123 nat_det_forward definition changed
124 nat_det_get_timeouts definition changed
125 nat_det_map_details only in image
126 nat_det_map_dump only in image
127 nat_det_reverse definition changed
128 nat_det_session_details only in image
129 nat_det_session_dump only in image
130 nat_det_set_timeouts definition changed
131 nat_ipfix_enable_disable definition changed
132 nat_set_workers definition changed
133 nat_show_config definition changed
134 nat_worker_details only in image
135 nat_worker_dump only in image
136 one_add_del_ndp_entry definition changed
137 one_enable_disable_petr_mode definition changed
138 one_enable_disable_pitr_mode definition changed
139 one_enable_disable_xtr_mode definition changed
140 one_get_transport_protocol definition changed
141 one_map_register_fallback_threshold definition changed
142 one_map_register_set_ttl definition changed
143 one_ndp_bd_get definition changed
144 one_ndp_entries_get definition changed
145 one_set_transport_protocol definition changed
146 one_show_petr_mode definition changed
147 one_show_pitr_mode definition changed
148 one_show_xtr_mode definition changed
149 p2p_ethernet_add definition changed
150 pppoe_add_del_session definition changed
151 pppoe_session_details only in image
152 pppoe_session_dump only in image
153 punt_socket_deregister definition changed
154 punt_socket_register definition changed
155 show_one_map_register_fallback_threshold definition changed
156 show_one_map_register_ttl definition changed
157 snat_interface_add_del_output_feature definition changed
158 snat_interface_output_feature_details only in image
159 snat_interface_output_feature_dump only in image
160 sw_interface_event only in image
161 sw_interface_set_flags definition changed
162 sw_interface_span_dump definition changed
163 sw_interface_span_enable_disable definition changed
164 sw_interface_vhost_user_details definition changed
165 tcp_configure_src_addresses definition changed
166 vnet_per_interface_combined_counters only in image
167 vnet_per_interface_simple_counters only in image
168 want_interface_combined_stats definition changed
169 want_interface_simple_stats definition changed
170 want_ip4_fib_stats definition changed
171 want_ip4_nbr_stats definition changed
172 want_ip6_fib_stats definition changed
173 want_ip6_nbr_stats definition changed
174 want_l2_macs_events definition changed
175 want_per_interface_combined_stats definition changed
176 want_per_interface_simple_stats definition changed
177 Found 103 api message signature differences
179 Patches that updated the API files:
181 ./src/plugins/pppoe/pppoe.api
182 62f9cdd8 Add PPPoE Plugin
184 ./src/plugins/acl/acl.api
185 c29940c5 ACL-plugin add "replace" semantics for adding a new MacIP acl
186 de9fbf43 MAC IP ACL interface list dump (as an alternative to the get/reply)
188 ./src/plugins/nat/nat.api
189 704018cf NAT: Destination NAT44 with load-balancing (VPP-954)
190 2ba92e32 NAT: Rename snat plugin to nat (VPP-955)
192 ./src/vnet/interface.api
193 831fb59f Stats refactor
194 d292ab1e No context in SW interface event
195 a07bd708 Dedicated SW Interface Event
197 ./src/vnet/dhcp/dhcp.api
198 51822bf0 DHCP client option 61 "client_id"
199 4729b1ec DHCP complete event sends mask length
201 ./src/vnet/lldp/lldp.api
202 99a0e60e Add API support for LLDP config/interface set
204 ./src/vnet/lisp-cp/one.api
205 d630713d LISP: add neighbor discovery and CP protocol separation APIs
206 111a5cea LISP: Add APIs for enable/disable xTR/P-ITR/P-ETR modes
207 7048ff1e LISP: Map-server fallback feature
208 1e553a00 LISP: make TTL for map register messages configurable
210 ./src/vnet/ethernet/p2p_ethernet.api
211 15ac81c1 P2P Ethernet
213 ./src/vnet/mpls/mpls.api
214 2297af01 Add a name to the creation of an IP and MPLS table
215 28ab9cc1 FIB table add/delete API only
216 da78f957 L2 over MPLS
217 a0a908f1 FIB path weight incorrect in dump (VPP-922)
218 57b5860f FIB path preference
220 ./src/vnet/session/session.api
221 33e002b1 Fix session connect api message handling.
223 ./src/vnet/span/span.api
224 5b311202 SPAN/API:enable L2 dump
225 001fd406 SPAN:add l2 mirror
227 ./src/vnet/devices/virtio/vhost_user.api
228 4ba75f54 vhost: Remove operation mode in the API
230 ./src/vnet/vxlan-gpe/vxlan_gpe.api
231 04ffd0ad VPP crash on creating vxlan gpe interface. VPP-875
233 ./src/vnet/tcp/tcp.api
234 3bbcfab1 TCP source address automation
237 2297af01 Add a name to the creation of an IP and MPLS table
238 28ab9cc1 FIB table add/delete API only
239 57b5860f FIB path preference
241 ./src/vnet/lisp-gpe/lisp_gpe.api
242 af3d9771 Remove unused retval from gpe_native_fwd_rpath type definition
245 50570ece Update of free text tag patch for BD
246 48304141 Support for bridge domain free text tag
247 e531f4cb Increase default MAC learn limit and check it in learn-update path
248 8d00fff8 Add support for API client to receive L2 MAC events
250 ./src/vpp/api/vpe.api
251 8a19f12a Allow individual stats API and introduce stats.api
252 4802632d Punt socket: Fix coverity error for pathname length mismatch between API and sun_path.
253 f7a55ad7 PUNT socket: External control plane processes connected via UNIX domain sockets.
254 75e2f2ac API:fix arp/ND event messages - remove context
255 99a0e60e Add API support for LLDP config/interface set
257 ./src/vpp/stats/stats.api
258 831fb59f Stats refactor
259 8a19f12a Allow individual stats API and introduce stats.api
261 @page release_notes_1707 Release notes for VPP 17.07
263 More than 400 commits since the 1704 release.
267 - make test; improved debuggability.
268 - TAB auto-completion on the CLI
270 - python 3 support in test infra
273 - Improved Linux TCP stack compatibility using IWL test suite (https://jira.fd.io/browse/VPP-720)
274 - Improved loss recovery (RFC5681, RFC6582, RF6675)
275 - Basic implementation of Eifel detection algorithm (RFC3522)
276 - Basic support for buffer chains
277 - Refactored session layer API
278 - Overall performance, scale and hardening
281 - memif: IP mode, jumbo frames, multi queue
282 - virtio-user support
283 - vhost-usr; adaptive (poll/interupt) support.
288 - BFD FIB integration
294 - Segement routing MPLS
296 - IOAM configuration for SRv6 localsid
300 - native forward static routes
303 - ACL multi-core suuport
306 - Add flowstartns, flowendns and tcpcontrolbits
307 - Stateful flows and IPv6, L4 recording
311 - VXLAN GPE support for FIB2.0 and bypass.
316 For the full list of issues please reffer to fd.io [JIRA](https://jira.fd.io).
320 For the full list of fixed issues please reffer to:
321 - fd.io [JIRA](https://jira.fd.io)
322 - git [commit log](https://git.fd.io/vpp/log/?h=stable/1707)
324 @page release_notes_1704 Release notes for VPP 17.04
326 More than 500 commits since the 1701 release.
330 - make test improvements
331 - vnet: add device-input threadplacement infra
332 - 64 bit per-thread counters
333 - process restart cli
334 - High performance timer wheels
335 - Plugin infrastructure improvements
336 - Support for .default_disabled, .version_required
337 - Added MAINTAINERS file
340 - TCP stack (experimental)
341 - DHCPv4 / DHCPv6 relay multi-destination
345 - Consolidated DHCPv4 and DHCPv6 implementation
348 - DPDK 17.02 (retire support for DPDK 16.07)
349 - Add memif - packet memory interface for intra-host communication
350 - vhost: support interrupt mode
351 - DPDK as plugin (retired vpp_lite)
352 - DPDPK input optimizations
353 - Loopback interface allocation scheme
359 - Learning on local interfaces
360 - Flushing of MACs from the L2 FIB
363 - CGN (Deterministic and dynamic)
364 - CGN configurable port allocation algorithm
366 - Tentant VRF id for SNAT outside addresses
367 - Session dump / User dump
368 - Port allocation per protocol
371 - Routed interface support
372 - L2+L3 unified processing node
373 - Improve fragment handling
375 - Segement routing v6
376 - SR policies with weighted SID lists
378 - SR steering policies
380 - Framework to expand local SIDs w/plugins
384 - UDP Pinger w/path fault isolation
385 - IOAM as type 2 metadata in NSH
386 - IAOM raw IPFIX collector and analyzer
387 - Anycast active server selection
390 - IP6 HBH header and SR header co-existence
394 - Statistics collection
395 - Generalize encap for overlay transport (vxlan-gpe support)
396 - Improve data plane speed
400 - NSH added to encap/decap path
401 - Renamed LISP GPE API to GPE
404 - Performance improvements (quad loop)
407 - Command line interface
410 - SHA1 authentication
413 - IKEv2 initiator features
416 - unify IP4/IP6 control plane handling
420 - Python API: To avoid conflicts between VPP API messages names and
421 the Python API binding function names, VPP API methods are put in a
422 separate proxy object.
423 https://gerrit.fd.io/r/#/c/5570/
424 The api methods are now referenced as:
425 vpp_handle = VPP(jsonfiles)
426 vpp_handle.connect(...)
429 vpp_handle.disconnect()
431 For backwards compatibility VPP API methods are left in the main
432 name space (VPP), but will be removed from 17.07.
434 - Python API: Change from cPython to CFFI.
436 - create_loopback message to be replaced with create_loopback_instance
437 create_loopback will be removed from 17.07.
438 https://gerrit.fd.io/r/#/c/5572/
442 For the full list of issues please reffer to fd.io [JIRA](https://jira.fd.io).
446 For the full list of fixed issues please reffer to:
447 - fd.io [JIRA](https://jira.fd.io)
448 - git [commit log](https://git.fd.io/vpp/log/?h=stable/1704)
450 @page release_notes_17011 Release notes for VPP 17.01.1
452 This is bug fix release.
454 For the full list of fixed issues please reffer to:
455 - fd.io [JIRA](https://jira.fd.io)
456 - git [commit log](https://git.fd.io/vpp/log/?h=stable/1701)
459 @page release_notes_17011 Release notes for VPP 17.01.1
461 This is bug fix release.
463 For the full list of fixed issues please reffer to:
464 - fd.io [JIRA](https://jira.fd.io)
465 - git [commit log](https://git.fd.io/vpp/log/?h=stable/1701)
467 @page release_notes_1701 Release notes for VPP 17.01
469 @note This release was for a while known as 16.12.
473 - [Integrated November 2016 DPDK release](http://www.dpdk.org/doc/guides/rel_notes/release_16_11.html)
475 - Complete rework of Forwarding Information Base (FIB)
477 - Performance Improvements
478 - Improvements in DPDK input and output nodes
479 - Improvements in L2 path
480 - Improvmeents in IPv4 lookup node
482 - Feature Arcs Improvements
483 - Consolidation of the code
488 - DPDK Cryptodev Support
489 - Software and Hardware Crypto Support
493 - Simple Port Analyzer (SPAN)
495 - Bidirectional Forwarding Detection
496 - Basic implementation
500 - L2 GRE over IPSec tunnels
502 - Link Layer Discovery Protocol (LLDP)
504 - Vhost-user Improvements
505 - Performance Improvements
510 - Source/Dest control plane support
511 - L2 over LISP and GRE
512 - Map-Register/Map-Notify/RLOC-probing support
513 - L2 API improvements, overall code hardening
517 - New: Flow per Packet
522 - Doxygen Enhancements
524 - Luajit API bindings
530 - Python and Scapy based unit testing infrastructure
534 - Packet Generator improvements
536 - TUN/TAP jumbo frames support
538 - Other various bug fixes and improvements
542 For the full list of issues please reffer to fd.io [JIRA](https://jira.fd.io).
546 For the full list of fixed issues please reffer to:
547 - fd.io [JIRA](https://jira.fd.io)
548 - git [commit log](https://git.fd.io/vpp/log/?h=stable/1701)
550 @page release_notes_1609 Release notes for VPP 16.09
554 - [Integrated July 2016 DPDK release](http://www.dpdk.org/doc/guides/rel_notes/release_16_07.html)
555 - DPDK-vhost is depreciated pending a complete rework of the original integration and
556 addressing of rx performance deltas.
557 - Patches required for DPDK 16.07:
558 - Correctly setting the Packet Type in the IGB, IXGBE and i40e drivers.
559 - Correctly setting checksum in the i40e driver.
560 - NXP DPAA2 PMD Driver.
561 - rte_delay (yield) functionality.
563 - Add “in tree” plugins:
569 - High-performance (line-rate) “neutron like” L4 port-filtering.
571 - API refactoring - addressing some of the issues around JVPP bindings.
572 - Accommodating plugins [(e.g. NSH_SFC)](https://wiki.fd.io/view/NSH_SFC)
573 - Binding for [python](https://wiki.fd.io/view/VPP/Python_API)
580 - Map-resolver failover algorithm
582 - Support 64-bit vector lengths, huge shared-memory segments.
584 - Dynamic IP Feature ordering
585 - IP Features can now specify features they appear before and after
588 - Ubuntu 14.04 LTS - Trusty Tahr
589 - Ubuntu 16.04 LTS - Xenial Xerus
591 - More information on [VPP wiki](https://wiki.fd.io/view/VPP/Installing_VPP_binaries_from_packages)
593 - Performance, characterize and document performance for this release
594 [(more information on CSIT page)](https://wiki.fd.io/view/CSIT)
596 - IPv4 and IPv6 Scale - performance tests.
597 - Bidirectional 10k/100k/1M flows.
598 - 64B,570B, 1518B,9000B packet sizes.
599 - IPv6 iACL - performance
600 - DUT1 and DUT2 are configured with IPv6 routing, two static IPv6 /64 routes and IPv6 iAcl
601 security whitelist ingress /64 filter entries applied on links.
602 - TG traffic profile contains two L3 flow-groups (flow-group per direction, 253 flows per
603 flow-group) with all packets containing Ethernet header, IPv6 header and generated payload.
604 MAC addresses are matching MAC addresses of the TG node interfaces.
606 - L2XC VXLANoIPv4 - performance
607 - DUT1 and DUT2 are configured with L2 cross-connect. VXLAN tunnels are configured between
608 L2XCs on DUT1 and DUT2.
609 - TG traffic profile contains two L3 flow-groups (flow-group per direction, 253 flows per
610 flow-group) with all packets containing Ethernet header, IPv4 header with IP protocol=61
611 and generated payload. MAC addresses are matching MAC addresses of the TG node interfaces.
614 - Autogenerated CLI documentation.
615 - Using doxygen to automate API/Node documentation.
616 - [(available online)](https://docs.fd.io/vpp/16.09/)
618 - Resolved all static analysis issues found by Coverity
619 - Beginning of 16.09 cycle: 505 issues.
620 - Release: 0 outstanding issues.
625 Issues in fd.io are tracked in [JIRA](https://jira.fd.io).
629 VPP-391 | vpp debug version assert appeared in the process of start
630 VPP-380 | Mapping algorithm compute wrong ea-bits when IPv4 prefix 0.0.0.0/0
631 VPP-371 | load_one_plugin:63: Loaded plugin: message from vppctl
632 VPP-367 | vpp packages need to depend on specific versions of each other
633 VPP-312 | IP6 FIB gets in indeterminate state by duplicating commands
634 VPP-224 | Lookup-in-vrf can not be set correctly
635 VPP-206 | Fix classify table delete
636 VPP-203 | Fix binary API for reading vpp node graph
637 VPP-147 | Inconsistent behaviour when adding L2 FIB filter entry
638 VPP-99 | VPP doesn't discard DHCPOFFER message with wrong XID
643 Issues in fd.io are tracked in [JIRA](https://jira.fd.io).
647 VPP-396 | Ubuntu systems Graphviz bug
648 VPP-390 | vpp-lib rpm fails to include *.so symlinks, causing linking problems with out of tree builds
649 VPP-388 | IPSec output feature assumes packets have been ethernet rewritten
650 VPP-385 | ARP for indirect adjacencies not working correctly
651 VPP-361 | Memory leak on delete of VXLAN over IPv6 tunnel
652 VPP-357 | VNI not set correctly when removing LISP fwd entries
653 VPP-349 | sw_interface_vhost_user_dump not working
654 VPP-345 | net/enic: bad L4 checksum ptype set on ICMP packets
655 VPP-340 | MAP-T wrong destination address
656 VPP-330 | Use fifo to store LISP pending map-requests
657 VPP-326 | map_add_domain VAT command: unable to configure domain with mtu parameter
658 VPP-318 | The map_add_domain VAT command accepts invalid arguments
659 VPP-315 | Fix "show vxlan-gpe" issue
660 VPP-310 | Mapping algorithm compute wrong ea-bits
661 VPP-239 | LISP IP forwarding does not tag packets that hit negative mapping entries
662 VPP-235 | Invalid help in VAT for sw_interface_set_l2_bridge
663 VPP-228 | Mapping algorithm sends packet to wrong IPv6 address
664 VPP-214 | vpp-api-test: api_ipsec_sad_add_del_entry: vector "ck" not initialized
665 VPP-200 | VPP - TAP port create problem
666 VPP-189 | Coverity Issues for 16.09
667 VPP-184 | u16 translating to char ,not short
668 VPP-179 | Adjacency share-count botch
669 VPP-163 | "show ip6 interface" ignores non-global addresses
670 VPP-155 | Netmap: Inconsistency in interface state between "show hardware" and "show interface"
671 VPP-145 | Dynamically compute IP feature ordering based on constraints
672 VPP-137 | VPP sends ARP with wrong requested IP
673 VPP-118 | JVpp: 0 length arrays not handled properly in VPP responses
674 VPP-112 | linux kernel info missing from build log
675 VPP-110 | vxlan encap node should never touch a deleted tunnel
676 VPP-107 | RPM build broken in master
677 VPP-92 | segment routing is not properly filling out the segment list
678 VPP-91 | segment routing add/del tunnel lookup doesn't work
679 VPP-84 | af_packet throws a fatal error on EAGAIN
680 VPP-74 | Clang compile fails due to warning in vlib/unix/cli.c
681 VPP-64 | Top level "make pkg-deb" fails if CDPATH is set in user env.
682 VPP-48 | Traceroute does not terminate when VPP is the target
683 VPP-23 | CLI pager does not gracefully handle lines longer than the terminal width
686 @page release_notes_1606 Release notes for VPP 16.06
689 The FD.io Project, relentlessly focused on data IO speed and efficiency
690 supporting the creation of high performance, flexible, and scalable software
691 defined infrastructures, announces the availability of the community’s first
692 software release (16.06).
694 In the four months since launching, FD.io has brought together more than 75
695 developers from 11 different companies including network operators, solution
696 providers chip vendors, and network equipment vendors who are collaborating to
697 enhance and innovate around the Vector Packet Processing (VPP) technology. The
698 FD.io community has quickly formed to grow the number of projects from the
699 initial VPP project to an additional 6 projects addressing a diverse set of
700 requirements and usability across a variety of deployment environments.
702 The 16.06 release brings unprecedented performance: 480Gbps/200mpps with 8
703 million routes and 2k whitelist entries on standard high volume x86 servers.
708 In addition to the existing full suite of vswitch/vrouter features, the new
711 * Enhanced Switching and Routing:
712 * IPv6 Segment Routing multicast support.
714 * VXLAN over IPv6 underlay.
715 * Per interface whitelists.
716 * Shared adjacencies in FIB.
718 * New and improved interface support:
719 * Jumbo frame support for vhost-user.
720 * Netmap interface support.
721 * AF_Packet interface support.
723 * Expanded and improved programmability:
724 * Python API bindings.
725 * Enhanced JVPP Java API bindings.
728 * Expanded Hardware and Software Support:
729 * Support for ARM 32 targets including Rasberry Pi single-board computer.
730 * Support for DPDK 16.04.