]> git.proxmox.com Git - mirror_ovs.git/blame - NEWS
ofproto: Fix wrong datapath flow with same in_port and output port.
[mirror_ovs.git] / NEWS
CommitLineData
71d474b3
JP
1Post-v2.9.0
2--------------------
1fe178d2
EG
3 - OpenFlow:
4 * ct_clear action is now backed by kernel datapath. Support is probed for
5 when OVS starts.
71d474b3 6
bb4df7f4 7v2.9.0 - xx xxx xxxx
e656b165 8--------------------
9a180f2c 9 - NSH implementation now conforms to latest draft (draft-ietf-sfc-nsh-28).
17553f27 10 * Add ttl field.
491e05c2 11 * Add a new action dec_nsh_ttl.
12b84d50
BP
12 - OVSDB:
13 * New high-level documentation in ovsdb(7).
14 * New file format documentation for developers in ovsdb(5).
15 * Protocol documentation moved from ovsdb-server(1) to ovsdb-server(7).
838f9c31 16 * ovsdb-client: New "get-schema-cksum" and "query" commands.
fe0fb885 17 * ovsdb-client: New "backup" and "restore" commands.
439902cb 18 * ovsdb-tool: New "db-name" and "schema-name" commands.
80f66ee0
BP
19 - ovs-vsctl and other commands that display data in tables now support a
20 --max-column-width option to limit column width.
d39ec23d
JP
21 - No longer slow-path traffic that sends to a controller. Applications,
22 such as OVN ACL logging, want to send a copy of a packet to a
23 controller while leaving the actual packet forwarding in the datapath.
bd32425f
RB
24 - OVN:
25 * The "requested-chassis" option for a logical switch port now accepts a
26 chassis "hostname" in addition to a chassis "name".
d601127b
NS
27 * IPv6
28 - Added support to send IPv6 Router Advertisement packets in response to
29 the IPv6 Router Solicitation packets from the VIF ports.
30 - Added support to generate Neighbor Solicitation packets using the OVN
31 action 'nd_ns' to resolve unknown next hop MAC addresses for the
32 IPv6 packets.
74103dc2 33 * ovn-ctl: New commands run_nb_ovsdb and run_sb_ovsdb.
4a67e420
GR
34 - Linux kernel 4.13
35 * Add support for compiling OVS with the latest Linux 4.13 kernel
c92339ad
DB
36 - ovs-dpctl and related ovs-appctl commands:
37 * "flush-conntrack" now accept a 5-tuple to delete a specific
38 connection tracking entry.
875075b3
DB
39 * New "ct-set-maxconns", "ct-get-maxconns", and "ct-get-nconns" commands
40 for userspace datapath.
5e925ccc
MK
41 - DPDK:
42 * Add support for DPDK v17.11
a14d1cc8 43 * Add support for vHost IOMMU
be481733 44 * New debug appctl command 'netdev-dpdk/get-mempool-info'.
40f185ac 45 * All the netdev-dpdk appctl commands described in ovs-vswitchd man page.
971f4b39
MW
46 * Custom statistics:
47 - DPDK physical ports now return custom set of "dropped", "error" and
48 "management" statistics.
49 - ovs-ofctl dump-ports command now prints new of set custom statistics
50 if available (for OpenFlow 1.4+).
c190e2ad
KT
51 * New appctl command 'dpif-netdev/pmd-rxq-rebalance' to rebalance rxq to
52 pmd assignments.
2a2c67b4 53 * Add rxq utilization of pmd to appctl 'dpif-netdev/pmd-rxq-show'.
06ee1d3e
IM
54 - Userspace datapath:
55 * Output packet batching support.
62705b81
BP
56 - vswitchd:
57 * Datapath IDs may now be specified as 0x1 (etc.) instead of 16 digits.
d3b84833
BP
58 * Configuring a controller, or unconfiguring all controllers, now deletes
59 all groups and meters (as well as all flows).
d4042a70 60 - New --enable-sparse configure option enables "sparse" checking by default.
b2e8b12f 61 - Added additional information to vhost-user status.
e656b165 62
a61016be 63v2.8.0 - 31 Aug 2017
3a32d0ae 64--------------------
1b3758c3
BP
65 - ovs-ofctl:
66 * ovs-ofctl can now accept and display port names in place of numbers. By
67 default it always accepts names and in interactive use it displays them;
68 use --names or --no-names to override. See ovs-ofctl(8) for details.
69 * "ovs-ofctl dump-flows" now accepts --no-stats to omit flow statistics.
8a0d9d85 70 - New ovs-dpctl command "ct-stats-show" to show connection tracking stats.
e2218eee
JP
71 - Tunnels:
72 * Added support to set packet mark for tunnel endpoint using
73 `egress_pkt_mark` OVSDB option.
921c370a
EG
74 * When using Linux kernel datapath tunnels may be created using rtnetlink.
75 This will allow us to take advantage of new tunnel features without
76 having to make changes to the vport modules.
4c30b246
CL
77 - EMC insertion probability is reduced to 1% and is configurable via
78 the new 'other_config:emc-insert-inv-prob' option.
736ca516
IM
79 - DPDK:
80 * DPDK log messages redirected to OVS logging subsystem.
81 Log level can be changed in a usual OVS way using
82 'ovs-appctl vlog' commands for 'dpdk' module. Lower bound
83 still can be configured via extra arguments for DPDK EAL.
28ca969e
AC
84 * dpdkvhostuser ports are marked as deprecated. They will be removed
85 in an upcoming release.
f3e7ec25 86 * Support for DPDK v17.05.1.
0b4f83e2
PS
87 - IPFIX now provides additional counters:
88 * Total counters since metering process startup.
89 * Per-flow TCP flag counters.
ebfe9a21 90 * Multicast, broadcast, and unicast counters.
fed8962a
EG
91 - New support for multiple VLANs (802.1ad or "QinQ"), including a new
92 "dot1q-tunnel" port VLAN mode.
4e3000a0
BP
93 - In ovn-vsctl and vtep-ctl, record UUIDs in commands may now be
94 abbreviated to 4 hex digits.
3346c985
DB
95 - Userspace Datapath:
96 * Added NAT support for userspace datapath.
05f282c2 97 * Added FTP and TFTP support with NAT for userspace datapath.
ab27bfa6 98 * Experimental NSH (Network Service Header) support in userspace datapath.
b89d25e5 99 - OVN:
302eda27 100 * New built-in DNS support.
161ea2c8 101 * IPAM for IPv4 can now exclude user-defined addresses from assignment.
7cc0741e 102 * IPAM can now assign IPv6 addresses.
b89d25e5 103 * Make the DHCPv4 router setting optional.
f40c5588 104 * Gratuitous ARP for NAT addresses on a distributed logical router.
4d232c75
LR
105 * Allow ovn-controller SSL configuration to be obtained from vswitchd
106 database.
42c1e58e 107 * ovn-trace now has basic support for tracing distributed firewalls.
4e3000a0
BP
108 * In ovn-nbctl and ovn-sbctl, record UUIDs in commands may now be
109 abbreviated to 4 hex digits.
c2f4c39b
BP
110 * "ovn-sbctl lflow-list" can now print OpenFlow flows that correspond
111 to logical flows.
75ddb5f4 112 * Now uses OVSDB RBAC support to reduce impact of compromised hypervisors.
35ad41ba
RB
113 * Multiple chassis may now be specified for L3 gateways. When more than
114 one chassis is specified, OVN will manage high availability for that
115 gateway.
d383eed5 116 * Add support for ACL logging.
46a54ce7 117 * ovn-northd now has native support for active-standby high availability.
0f2f05bb 118 - Tracing with ofproto/trace now traces through recirculation.
d6db7b3c
LR
119 - OVSDB:
120 * New support for role-based access control (see ovsdb-server(1)).
cc3a32f3 121 - New commands 'stp/show' and 'rstp/show' (see ovs-vswitchd(8)).
417cfdb6 122 - OpenFlow:
8d348579
BP
123 * All features required by OpenFlow 1.4 are now implemented, so
124 ovs-vswitchd now enables OpenFlow 1.4 by default (in addition to
125 OpenFlow 1.0 to 1.3).
2f2b904f 126 * Increased support for OpenFlow 1.6 (draft).
417cfdb6 127 * Bundles now support hashing by just nw_src or nw_dst.
128 * The "learn" action now supports a "limit" option (see ovs-ofctl(8)).
f73b83fd 129 * The port status bit OFPPS_LIVE now reflects link aliveness.
577bfa9f 130 * OpenFlow 1.5 packet-out is now supported.
f839892a
JS
131 * Support for OpenFlow 1.5 field packet_type and packet-type-aware
132 pipeline (PTAP).
133 * Added generic encap and decap actions (EXT-382).
134 First supported use case is encap/decap for Ethernet.
b48f44ff
YY
135 * Added NSH (Network Service Header) support in userspace
136 Used generic encap and decap actions to implement encapsulation and
137 decapsulation of NSH header.
138 IETF NSH draft - https://datatracker.ietf.org/doc/draft-ietf-sfc-nsh/
f6fabcc6
JP
139 * Conntrack state is only available to the processing path that
140 follows the "recirc_table" argument of the ct() action. Starting
141 in OVS 2.8, this state is now cleared for the current processing
142 path whenever ct() is called.
44dd4cc4
LR
143 - Fedora Packaging:
144 * OVN services are no longer restarted automatically after upgrade.
e3e738a3 145 * ovs-vswitchd and ovsdb-server run as non-root users by default.
fe13ccdc 146 - Add --cleanup option to command 'ovs-appctl exit' (see ovs-vswitchd(8)).
63171f04 147 - L3 tunneling:
875ab130 148 * Use new tunnel port option "packet_type" to configure L2 vs. L3.
f839892a
JS
149 * In conjunction with PTAP tunnel ports can handle a mix of L2 and L3
150 payload.
439f39cb 151 * New vxlan tunnel extension "gpe" to support VXLAN-GPE tunnels.
875ab130 152 * New support for non-Ethernet (L3) payloads in GRE and VXLAN-GPE.
4cefc3da 153 - The BFD detection multiplier is now user-configurable.
2a85b7cc 154 - Add experimental support for hardware offloading
bf090264
RD
155 * HW offloading is disabled by default.
156 * HW offloading is done through the TC interface.
5d77b36b
BP
157 - IPv6 link local addresses are now supported on Linux. Use % to designate
158 the scope device.
e2218eee 159
a9c838b2 160v2.7.0 - 21 Feb 2017
92690eae 161---------------------
e18a1d08
ER
162 - Utilities and daemons that support SSL now allow protocols and
163 ciphers to be configured with --ssl-protocols and --ssl-ciphers.
a6095f81
BS
164 - OVN:
165 * QoS is now implemented via egress shaping rather than ingress policing.
1a03fc7d 166 * DSCP marking is now supported, via the new northbound QoS table.
6374d518 167 * IPAM now supports fixed MAC addresses.
440a9f4b 168 * Support for source IP address based routing.
d444a914
BP
169 * ovn-trace:
170 - New --ovs option to also print OpenFlow flows.
171 - put_dhcp_opts and put_dhcp_optsv6 actions may now be traced.
821302cf 172 * Support for managing SSL and remote connection configuration in
10471820 173 northbound and southbound databases.
84d0ca5d
LR
174 * TCP connections to northbound and southbound databases are no
175 longer enabled by default and must be explicitly configured.
176 See documentation for ovn-sbctl/ovn-nbctl "set-connection"
177 command or the ovn-ctl "--db-sb-create-insecure-remote" and
178 "--db-nb-create-insecure-remote" command-line options for
179 information regarding remote connection configuration.
714651c7
JP
180 * New appctl "inject-pkt" command in ovn-controller that allows
181 packets to be injected into the connected OVS instance.
878b54d7
MS
182 * Distributed logical routers may now be connected directly to
183 logical switches with localnet ports, by specifying a
184 "redirect-chassis" on the distributed gateway port of the
185 logical router. NAT rules may be specified directly on the
186 distributed logical router, and are handled either centrally on
187 the "redirect-chassis", or in many cases are handled locally on
188 the hypervisor where the corresponding logical port resides.
189 Gratuitous ARP for NAT addresses on a distributed logical
190 router is not yet supported, but will be added in a future
191 version.
a027899e
JR
192 - Fixed regression in table stats maintenance introduced in OVS
193 2.3.0, wherein the number of OpenFlow table hits and misses was
194 not accurate.
51bb26fa 195 - OpenFlow:
6dd3c787 196 * OFPT_PACKET_OUT messages are now supported in bundles.
53cc166a
JR
197 * A new "selection_method=dp_hash" type for OpenFlow select group
198 bucket selection that uses the datapath computed 5-tuple hash
199 without making datapath flows match the 5-tuple fields, which
200 is useful for more efficient load balancing, for example. This
201 uses the Netronome extension to OpenFlow 1.5+ that allows
202 control over the OpenFlow select groups selection method. See
203 "selection_method" and related options in ovs-ofctl(8) for
204 details.
4930ea56 205 * The "sample" action now supports "ingress" and "egress" options.
40c7b2fc 206 * The "ct" action now supports the TFTP ALG where support is available.
72fe7578 207 * New actions "clone" and "ct_clear".
798a1033 208 * The "meter" action is now supported in the userspace datapath.
6dd3c787
JR
209 - ovs-ofctl:
210 * 'bundle' command now supports packet-out messages.
211 * New syntax for 'ovs-ofctl packet-out' command, which uses the
212 same string parser as the 'bundle' command. The old 'packet-out'
213 syntax is deprecated and will be removed in a later OVS
214 release.
215 * New unixctl "ofctl/packet-out" command, which can be used to
216 instruct a flow monitor to issue OpenFlow packet-out messages.
9c1a1182
LR
217 - ovsdb-server:
218 * Remote connections can now be made read-only (see ovsdb-server(1)).
8d8ab6c2
JG
219 - Tunnels:
220 * TLV mappings for protocols such as Geneve are now segregated on
221 a per-OpenFlow bridge basis rather than globally. (The interface
222 has not changed.)
2b02d770 223 * Removed support for IPsec tunnels.
08484bae
CL
224 - DPDK:
225 * New option 'n_rxq_desc' and 'n_txq_desc' fields for DPDK interfaces
226 which set the number of rx and tx descriptors to use for the given port.
04de404e 227 * Support for DPDK v16.11.
1a2bb118 228 * Support for rx checksum offload. Refer DPDK HOWTO for details.
b8374d0d 229 * Port Hotplug is now supported.
55e075e6
CL
230 * DPDK physical ports can now have arbitrary names. The PCI address of
231 the device must be set using the 'dpdk-devargs' option. Compatibility
232 with the old dpdk<portid> naming scheme is broken, and as such a
233 device will not be available for use until a valid dpdk-devargs is
234 specified.
69876ed7 235 * Virtual DPDK Poll Mode Driver (vdev PMD) support.
602e24ee 236 * Removed experimental tag.
5771f476
FL
237 - Fedora packaging:
238 * A package upgrade does not automatically restart OVS service.
58d636ee
BK
239 - ovs-vswitchd/ovs-vsctl:
240 * Ports now have a "protected" flag. Protected ports can not forward
241 frames to other protected ports. Unprotected ports can receive and
242 forward frames to protected and other unprotected ports.
1ab39058
LR
243 - ovs-vsctl, ovn-nbctl, ovn-sbctl, vtep-ctl:
244 * Database commands now accept integer ranges, e.g. "set port
245 eth0 trunks=1-10" to enable trunking VLANs 1 to 10.
92690eae 246
62f0430e 247v2.6.0 - 27 Sep 2016
ca32170a 248---------------------
e921fc3f
JP
249 - First supported release of OVN. See ovn-architecture(7) for more
250 details.
92f8d65b 251 - ovsdb-server:
c383f3bf
LS
252 * New "monitor_cond" "monitor_cond_update" and "update2" extensions to
253 RFC 7047.
56085be5 254 - OpenFlow:
8225b3b7
JR
255 * OpenFlow 1.3+ bundles now expire after 10 seconds since the
256 last time the bundle was either opened, modified, or closed.
fe996936
JR
257 * OpenFlow 1.3 Extension 230, adding OpenFlow Bundles support, is
258 now implemented.
25070e04
JR
259 * OpenFlow 1.3+ bundles are now supported for group mods as well as
260 flow mods and port mods. Both 'atomic' and 'ordered' bundle
261 flags are supported for group mods as well as flow mods.
5fc0ad0a
JR
262 * Internal OpenFlow rule representation for load and set-field
263 actions is now much more memory efficient. For a complex flow
264 table this can reduce rule memory consumption by 40%.
265 * Bundles are now much more memory efficient than in OVS 2.5.
266 Together with memory efficiency improvements in OpenFlow rule
267 representation, the peak OVS resident memory use during a
268 bundle commit for large complex set of flow mods can be only
269 25% of that in OVS 2.5 (4x lower).
56085be5 270 * OpenFlow 1.1+ OFPT_QUEUE_GET_CONFIG_REQUEST now supports OFPP_ANY.
e016fb63 271 * OpenFlow 1.4+ OFPMP_QUEUE_DESC is now supported.
6c6eedc5 272 * OpenFlow 1.4+ OFPT_TABLE_STATUS is now supported.
bdcad671 273 * New property-based packet-in message format NXT_PACKET_IN2 with support
77ab5fd2
BP
274 for arbitrary user-provided data and for serializing flow table
275 traversal into a continuation for later resumption.
276 * New extension message NXT_SET_ASYNC_CONFIG2 to allow OpenFlow 1.4-like
277 control over asynchronous messages in earlier versions of OpenFlow.
bef3f465 278 * New OpenFlow extension NXM_NX_MPLS_TTL to provide access to MPLS TTL.
aaca4fe0
WT
279 * New output option, output(port=N,max_len=M), to allow truncating a
280 packet to size M bytes when outputting to port N.
88b87a36
JS
281 * New command OFPGC_ADD_OR_MOD for OFPT_GROUP_MOD message that adds a
282 new group or modifies an existing groups
54b78c95
JR
283 * The optional OpenFlow packet buffering feature is deprecated in
284 this release, and will be removed in the next OVS release
285 (2.7). After the change OVS always sends the 'buffer_id' as
286 0xffffffff in packet-in messages and will send an error
287 response if any other value of this field is included in
288 packet-out and flow mod sent by a controller. Controllers are
289 already expected to work properly in cases where the switch can
290 not buffer packets, so this change should not affect existing
291 users.
2a7c4805 292 * New OpenFlow extension NXT_CT_FLUSH_ZONE to flush conntrack zones.
4b684612 293 - Improved OpenFlow version compatibility for actions:
88c8ca26 294 * New OpenFlow extension to support the "group" action in OpenFlow 1.0.
0f2aaee9 295 * OpenFlow 1.0 "enqueue" action now properly translated to OpenFlow 1.1+.
56a91749
BP
296 * OpenFlow 1.1 "mod_nw_ecn" and OpenFlow 1.1+ "mod_nw_ttl" actions now
297 properly translated to OpenFlow 1.0.
e016fb63
BP
298 - ovs-ofctl:
299 * queue-get-config command now allows a queue ID to be specified.
25070e04
JR
300 * '--bundle' option can now be used with OpenFlow 1.3 and with group mods.
301 * New "bundle" command allows executing a mixture of flow and group mods
302 as a single atomic transaction.
8743fa8c 303 * New option "--color" to produce colorized output for some commands.
88b87a36 304 * New option '--may-create' to use OFPGC_ADD_OR_MOD in mod-group command.
c97320eb
WZ
305 - IPFIX:
306 * New "sampling_port" option for "sample" action to allow sampling
307 ingress and egress tunnel metadata with IPFIX.
308 * New ovs-ofctl commands "dump-ipfix-bridge" and "dump-ipfix-flow" to
309 dump bridge IPFIX statistics and flow based IPFIX statistics.
310 * New setting other-config:virtual_obs_id to add an arbitrary string
311 to IPFIX records.
6cf888b8 312 - Linux:
fe996936
JR
313 * OVS Linux datapath now implements Conntrack NAT action with all
314 supported Linux kernels.
315 * Support for truncate action.
6cf888b8
BS
316 * New QoS type "linux-noop" that prevents Open vSwitch from trying to
317 manage QoS for a given port (useful when other software manages QoS).
a14b8947
IM
318 - DPDK:
319 * New option "n_rxq" for PMD interfaces.
320 Old 'other_config:n-dpdk-rxqs' is no longer supported.
81acebda
IM
321 Not supported by vHost interfaces. For them number of rx and tx queues
322 is applied from connected virtio device.
3eb67853
IM
323 * New 'other_config:pmd-rxq-affinity' field for PMD interfaces, that
324 allows to pin port's rx queues to desired cores.
ce179f11
IM
325 * New appctl command 'dpif-netdev/pmd-rxq-show' to check the port/rxq
326 assignment.
327 * Type of log messages from PMD threads changed from INFO to DBG.
0bf765f7 328 * QoS functionality with sample egress-policer implementation.
bab69409
AC
329 * The mechanism for configuring DPDK has changed to use database
330 * Sensible defaults have been introduced for many of the required
331 configuration options
332 * DB entries have been added for many of the DPDK EAL command line
eac84432
AC
333 arguments. Additional arguments can be passed via the dpdk-extra
334 entry.
9509913a 335 * Add ingress policing functionality.
db8f13b0
CL
336 * PMD threads servicing vHost User ports can now come from the NUMA
337 node that device memory is located on if CONFIG_RTE_LIBRTE_VHOST_NUMA
338 is enabled in DPDK.
5cf3edb3
DDP
339 * Basic connection tracking for the userspace datapath (no ALG,
340 fragmentation or NAT support yet)
0a0f39df 341 * Support for DPDK 16.07
4b88d678 342 * Optional support for DPDK pdump enabled.
0072e931 343 * Jumbo frame support
41987644 344 * Remove dpdkvhostcuse port type.
c1ff66ac 345 * OVS client mode for vHost and vHost reconnect (Requires QEMU 2.7)
2d24d165 346 * 'dpdkvhostuserclient' port type.
847b8b02 347 - Increase number of registers to 16.
e7529141
BP
348 - ovs-benchmark: This utility has been removed due to lack of use and
349 bitrot.
06380128
BP
350 - ovs-appctl:
351 * New "vlog/close" command.
7fc28c50
AC
352 - ovs-ctl:
353 * Added the ability to selectively start the forwarding and database
354 functions (ovs-vswitchd and ovsdb-server, respectively).
acdd0764
AZ
355 - ovsdb-server:
356 * Remove max number of sessions limit, to enable connection scaling
357 testing.
99c8be3e
RB
358 - python:
359 * Added support for Python 3.4+ in addition to existing support
360 for 2.7+.
9b897c91
AA
361 - SELinux:
362 * Introduced SELinux policy package.
8063e095
PS
363 - Datapath Linux kernel compatibility.
364 * Dropped support for kernel older than 3.10.
42deb67d 365 * Removed VLAN splinters feature.
c3cbb286 366 * Datapath supports kernel upto 4.7.
80c4589a
PS
367 - Tunnels:
368 * Flow based tunnel match and action can be used for IPv6 address using
369 tun_ipv6_src, tun_ipv6_dst fields.
8a2d4905 370 * Added support for IPv6 tunnels, for details checkout FAQ.
9e9d0384 371 * Deprecated support for IPsec tunnels ports.
314ce647
AC
372 - A wrapper script, 'ovs-tcpdump', to easily port-mirror an OVS port and
373 watch with tcpdump
81d2f75c
AA
374 - Introduce --no-self-confinement flag that allows daemons to work with
375 sockets outside their run directory.
29dd784d
BP
376 - ovs-pki: Changed message digest algorithm from SHA-1 to SHA-512 because
377 SHA-1 is no longer secure and some operating systems have started to
378 disable it in OpenSSL.
56abcf49 379 - Add 'mtu_request' column to the Interface table. It can be used to
3a414a0a 380 configure the MTU of the ports.
29dd784d 381
c0fa821f
JS
382Known issues:
383 - Using openvswitch module in conjunction with upstream Linux tunnels:
384 * When using the openvswitch module distributed with OVS against kernel
385 versions 4.4 to 4.6, the openvswitch module cannot be loaded or used at
386 the same time as "ip_gre".
387 - Conntrack FTP ALGs: When using the openvswitch module distributed with
388 OVS, particular Linux distribution kernels versions may provide diminished
389 functionality. This typically affects active FTP data connections when
390 using "actions=ct(alg=ftp),..." in flow tables. Specifically:
391 * Centos 7.1 kernels (3.10.0-2xx) kernels are unable to correctly set
392 up expectations for FTP data connections in multiple zones,
393 eg "actions=ct(zone=1,alg=ftp),ct(zone=2,alg=ftp),...". Executing the
394 "ct" action for subsequent data connections may fail to determine that
395 the data connection is "related" to an existing connection.
396 * Centos 7.2 kernels (3.10.0-3xx) kernels may not establish FTP ALG state
397 correctly for NATed connections. As a result, flows that perform NAT,
398 eg "actions=ct(nat,ftp=alg,table=1),..." may fail to NAT the packet,
399 and will populate the "ct_state=inv" bit in the flow.
400
ca32170a 401
1c0383a9 402v2.5.0 - 26 Feb 2016
c4c7e593 403---------------------
e23812fc
BP
404 - Dropped support for Python older than version 2.7. As a consequence,
405 using Open vSwitch 2.5 or later on XenServer 6.5 or earlier (which
406 have Python 2.4) requires first installing Python 2.7.
0eb48fe1
BP
407 - OpenFlow:
408 * Group chaining (where one OpenFlow group triggers another) is
409 now supported.
f70b94de 410 * OpenFlow 1.4+ "importance" is now considered for flow eviction.
82c22d34 411 * OpenFlow 1.4+ OFPTC_EVICTION is now implemented.
de7d3c07 412 * OpenFlow 1.4+ OFPTC_VACANCY_EVENTS is now implemented.
03c72922 413 * OpenFlow 1.4+ OFPMP_TABLE_DESC is now implemented.
f6ecf944 414 * Allow modifying the ICMPv4/ICMPv6 type and code fields.
c61f4bc1
BP
415 * OpenFlow 1.4+ OFPT_SET_ASYNC_CONFIG and OFPT_GET_ASYNC_CONFIG are
416 now implemented.
6d5d1f3b
BP
417 - ovs-ofctl:
418 * New "out_group" keyword for OpenFlow 1.1+ matching on output group.
c61f4bc1
BP
419 - Tunnels:
420 * Geneve tunnels can now match and set options and the OAM bit.
421 * The nonstandard GRE64 tunnel extension has been dropped.
06994f87 422 - Support Multicast Listener Discovery (MLDv1 and MLDv2).
4249b547 423 - Add 'symmetric_l3l4' and 'symmetric_l3l4+udp' hash functions.
7321bda3 424 - sFlow agent now reports tunnel and MPLS structures.
548f9fe7
DDP
425 - New 'check-system-userspace', 'check-kmod' and 'check-kernel' Makefile
426 targets to run a new system testsuite. These tests can be run inside
427 a Vagrant box. See INSTALL.md for details
195360dc
AA
428 - Mark --syslog-target argument as deprecated. It will be removed in
429 the next OVS release.
e91b927d 430 - Added --user option to all daemons
07659514 431 - Add support for connection tracking through the new "ct" action
9daf2348
JS
432 and "ct_state"/"ct_zone"/"ct_mark"/"ct_label" match fields. Only
433 available on Linux kernels with the connection tracking module loaded.
a2e61be6
RB
434 - Add experimental version of OVN. OVN, the Open Virtual Network, is a
435 system to support virtual network abstraction. OVN complements the
436 existing capabilities of OVS to add native support for virtual network
437 abstractions, such as virtual L2 and L3 overlays and security groups.
f6bf8880
PM
438 - RHEL packaging:
439 * DPDK ports may now be created via network scripts (see README.RHEL).
4573fbd3
FL
440 - DPDK:
441 * Requires DPDK 2.2
442 * Added multiqueue support to vhost-user
db6e1383 443 * Note: QEMU 2.5+ required for multiqueue support
c4c7e593 444
2fac5fed 445v2.4.0 - 20 Aug 2015
2c7ea589 446---------------------
39c94593
JR
447 - Flow table modifications are now atomic, meaning that each packet
448 now sees a coherent version of the OpenFlow pipeline. For
449 example, if a controller removes all flows with a single OpenFlow
450 "flow_mod", no packet sees an intermediate version of the OpenFlow
451 pipeline where only some of the flows have been deleted.
db5076ee 452 - Added support for SFQ, FQ_CoDel and CoDel qdiscs.
557570fa
AW
453 - Add bash command-line completion support for ovs-vsctl Please check
454 utilities/ovs-command-compgen.INSTALL.md for how to use.
9d078ec2
BP
455 - The MAC learning feature now includes per-port fairness to mitigate
456 MAC flooding attacks.
18080541
BP
457 - New support for a "conjunctive match" OpenFlow extension, which
458 allows constructing OpenFlow matches of the form "field1 in
459 {a,b,c...} AND field2 in {d,e,f...}" and generalizations. For details,
cc23805c 460 see documentation for the "conjunction" action in ovs-ofctl(8).
423ede18
AW
461 - Add bash command-line completion support for ovs-appctl/ovs-dpctl/
462 ovs-ofctl/ovsdb-tool commands. Please check
463 utilities/ovs-command-compgen.INSTALL.md for how to use.
35f48b8b
BP
464 - The "learn" action supports a new flag "delete_learned" that causes
465 the learned flows to be deleted when the flow with the "learn" action
466 is deleted.
c1fc1411
JG
467 - Basic support for the Geneve tunneling protocol. It is not yet
468 possible to generate or match options. This is planned for a future
469 release. The protocol is documented at
470 http://tools.ietf.org/html/draft-gross-geneve-00
a413195e 471 - The OVS database now reports controller rate limiting statistics.
50b9699f 472 - sflow now exports information about LACP-based bonds, port names, and
3d2912f2 473 OpenFlow port numbers, as well as datapath performance counters.
fceef209
DDP
474 - ovs-dpctl functionality is now available for datapaths integrated
475 into ovs-vswitchd, via ovs-appctl. Some existing ovs-appctl
476 commands are now redundant and will be removed in a future
477 release. See ovs-vswitchd(8) for details.
79fe0f46 478 - OpenFlow:
1c38055d
JR
479 * OpenFlow 1.4 bundles are now supported for flow mods and port
480 mods. For flow mods, both 'atomic' and 'ordered' bundle flags
481 are trivially supported, as all bundled messages are executed
482 in the order they were added and all flow table modifications
483 are now atomic to the datapath. Port mods may not appear in
484 atomic bundles, as port status modifications are not atomic.
e60e935b 485 * IPv6 flow label and neighbor discovery fields are now modifiable.
d3cb080e
BP
486 * OpenFlow 1.5 extended registers are now supported.
487 * The OpenFlow 1.5 actset_output field is now supported.
488 * OpenFlow 1.5 Copy-Field action is now supported.
489 * OpenFlow 1.5 masked Set-Field action is now supported.
3c4e10fb 490 * OpenFlow 1.3+ table features requests are now supported (read-only).
1b0ee636 491 * Nicira extension "move" actions may now be included in action sets.
2e34a6a3
SS
492 * "resubmit" actions may now be included in action sets. The resubmit
493 is executed last, and only if the action set has no "output" or "group"
494 action.
ca26eb44 495 * OpenFlow 1.4+ flow "importance" is now maintained in the flow table.
0c4b9393
SH
496 * A new Netronome extension to OpenFlow 1.5+ allows control over the
497 fields hashed for OpenFlow select groups. See "selection_method" and
498 related options in ovs-ofctl(8) for details.
db5076ee
JR
499 - ovs-ofctl has a new '--bundle' option that makes the flow mod commands
500 ('add-flow', 'add-flows', 'mod-flows', 'del-flows', and 'replace-flows')
501 use an OpenFlow 1.4 bundle to operate the modifications as a single
39c94593
JR
502 atomic transaction. If any of the flow mods in a transaction fail, none
503 of them are executed. All flow mods in a bundle appear to datapath
504 lookups simultaneously.
db5076ee
JR
505 - ovs-ofctl 'add-flow' and 'add-flows' commands now accept arbitrary flow
506 mods as an input by allowing the flow specification to start with an
507 explicit 'add', 'modify', 'modify_strict', 'delete', or 'delete_strict'
508 keyword. A missing keyword is treated as 'add', so this is fully
509 backwards compatible. With the new '--bundle' option all the flow mods
39c94593 510 are executed as a single atomic transaction using an OpenFlow 1.4 bundle.
4a1f9610 511 - ovs-pki: Changed message digest algorithm from MD5 to SHA-1 because
9ff33ca7
BP
512 MD5 is no longer secure and some operating systems have started to disable
513 it in OpenSSL.
09e25603
TW
514 - ovsdb-server: New OVSDB protocol extension allows inequality tests on
515 "optional scalar" columns. See ovsdb-server(1) for details.
ff495b63
BP
516 - ovs-vsctl now permits immutable columns in a new row to be modified in
517 the same transaction that creates the row.
0bc1b46a
BP
518 - test-controller has been renamed ovs-testcontroller at request of users
519 who find it useful for testing basic OpenFlow setups. It is still not
520 a necessary or desirable part of most Open vSwitch deployments.
cccf7e9d 521 - Support for travis-ci.org based continuous integration builds has been
542cc9bb 522 added. Build failures are reported to build@openvswitch.org. See INSTALL.md
cccf7e9d 523 file for additional details.
bbda3a2f
DV
524 - Support for the Rapid Spanning Tree Protocol (IEEE 802.1D-2004).
525 The implementation has been tested successfully against the Ixia Automated
526 Network Validation Library (ANVL).
2f9dd77f 527 - Stats are no longer updated on fake bond interface.
3e5aeeb5 528 - Keep active bond slave selection across OVS restart.
ec8f0f0c 529 - A simple wrapper script, 'ovs-docker', to integrate OVS with Docker
62dbc5bd
GS
530 containers. If and when there is a native integration of Open vSwitch
531 with Docker, the wrapper script will be retired.
e5a1caee
JG
532 - Added support for DPDK Tunneling. VXLAN, GRE, and Geneve are supported
533 protocols. This is generic tunneling mechanism for userspace datapath.
e3102e42 534 - Support for multicast snooping (IGMPv1, IGMPv2 and IGMPv3)
3afcde43 535 - Support for Linux kernels up to 4.0.x
d5460484
GS
536 - The documentation now use the term 'destination' to mean one of syslog,
537 console or file for vlog logging instead of the previously used term
538 'facility'.
ac6073e3 539 - Support for VXLAN Group Policy extension
99eef98b
DF
540 - Initial support for the IETF Auto-Attach SPBM draft standard. This
541 contains rudimentary support for the LLDP protocol as needed for
542 Auto-Attach.
d4763d1d
JP
543 - The default OpenFlow and OVSDB ports are now the IANA-assigned
544 numbers. OpenFlow is 6653 and OVSDB is 6640.
58397e6c 545 - Support for DPDK vHost.
4752cc0c 546 - Support for outer UDP checksums in Geneve and VXLAN.
d0d986a5
TG
547 - The kernel vports with dependencies are no longer part of the overall
548 openvswitch.ko but built and loaded automatically as individual kernel
549 modules (vport-*.ko).
4237026e 550 - Support for STT tunneling.
6901639b
BP
551 - ovs-sim: New developer tool for simulating multiple OVS instances.
552 See ovs-sim(1) for more information.
fe089c0d
AA
553 - Support to configure method (--syslog-method argument) that determines
554 how daemons will talk with syslog.
532e1463
AA
555 - Support for "ovs-appctl vlog/list-pattern" command that lets to query
556 logging message format for each destination.
2c7ea589
JP
557
558
e13440fc 559v2.3.0 - 14 Aug 2014
c5cf1059 560---------------------
6dc53744
BP
561 - OpenFlow 1.1, 1.2, and 1.3 are now enabled by default in
562 ovs-vswitchd.
69d6040e
JR
563 - Linux kernel datapath now has an exact match cache optimizing the
564 flow matching process.
565 - Datapath flows now have partially wildcarded tranport port field
566 matches. This reduces userspace upcalls, but increases the
567 number of different masks in the datapath. The kernel datapath
568 exact match cache removes the overhead of matching the incoming
569 packets with the larger number of masks, but when paired with an
570 older kernel module, some workloads may perform worse with the
571 new userspace.
0877a018 572 - Compatibility with autoconf 2.63 (previously >=2.64)
c5cf1059 573
012c3a52 574v2.2.0 - Internal Release
bff46ebb 575---------------------
1839c356
FL
576 - Internal ports are no longer brought up by default, because it
577 should be an administrator task to bring up devices as they are
578 configured properly.
c3ccfe98
AZ
579 - ovs-vsctl now reports when ovs-vswitchd fails to create a new port or
580 bridge.
9500f505
TG
581 - Port creation and configuration errors are now stored in a new error
582 column of the Interface table and included in 'ovs-vsctl show'.
7868fbc6
BP
583 - The "ovsdbmonitor" graphical tool has been removed, because it was
584 poorly maintained and not widely used.
e3c7ed29 585 - New "check-ryu" Makefile target for running Ryu tests for OpenFlow
542cc9bb 586 controllers against Open vSwitch. See INSTALL.md for details.
f51e8ccb 587 - Added IPFIX support for SCTP flows and templates for ICMPv4/v6 flows.
0b114fa0
GS
588 - Upon the receipt of a SIGHUP signal, ovs-vswitchd no longer reopens its
589 log file (it will terminate instead). Please use 'ovs-appctl vlog/reopen'
590 instead.
e2f3178f 591 - Support for Linux kernels up to 3.14. From Kernel 3.12 onwards OVS uses
cb25142c 592 tunnel API for GRE and VXLAN.
8a9562d2 593 - Added DPDK support.
a5ed8fe3 594 - Added support for custom vlog patterns in Python
f51e8ccb 595
bff46ebb 596
a3aabcd2 597v2.1.0 - 19 Mar 2014
b366c1f4 598---------------------
13751fd8
JR
599 - Address prefix tracking support for flow tables. New columns
600 "prefixes" in OVS-DB table "Flow_Table" controls which packet
601 header fields are used for address prefix tracking. Prefix
602 tracking allows the classifier to skip rules with longer than
603 necessary prefixes, resulting in better wildcarding for datapath
604 flows. Default configuration is to not use any fields for prefix
605 tracking. However, if any flow tables contain both exact matches
606 and masked matches for IP address fields, OVS performance may be
607 increased by using this feature.
608 * As of now, the fields for which prefix lookup can be enabled
609 are: 'tun_id', 'tun_src', 'tun_dst', 'nw_src', 'nw_dst' (or
610 aliases 'ip_src' and 'ip_dst'), 'ipv6_src', and 'ipv6_dst'.
611 (Using this feature for 'tun_id' would only make sense if the
612 tunnel IDs have prefix structure similar to IP addresses.)
613 * There is a maximum number of fields that can be enabled for any
614 one flow table. Currently this limit is 3.
615 * Examples:
616 $ ovs-vsctl set Bridge br0 flow_tables:0=@N1 -- \
617 --id=@N1 create Flow_Table name=table0
618 $ ovs-vsctl set Bridge br0 flow_tables:1=@N1 -- \
619 --id=@N1 create Flow_Table name=table1
620 $ ovs-vsctl set Flow_Table table0 prefixes=ip_dst,ip_src
621 $ ovs-vsctl set Flow_Table table1 prefixes=[]
bcb8bde4
JR
622 - TCP flags matching: OVS now supports matching of TCP flags. This
623 has an adverse performance impact when using OVS userspace 1.10
624 or older (no megaflows support) together with the new OVS kernel
625 module. It is recommended that the kernel and userspace modules
626 both are upgraded at the same time.
36359150
JP
627 - The default OpenFlow and OVSDB ports will change to
628 IANA-assigned numbers in a future release. Consider updating
629 your installations to specify port numbers instead of using the
630 defaults.
7fdb60a7
SH
631 - OpenFlow:
632 * The OpenFlow 1.1+ "Write-Actions" instruction is now supported.
484c8355
BP
633 * OVS limits the OpenFlow port numbers it assigns to port 32767 and
634 below, leaving port numbers above that range free for assignment
635 by the controller.
4abb8608
BP
636 * ovs-vswitchd now honors changes to the "ofport_request" column
637 in the Interface table by changing the port's OpenFlow port
638 number.
5dc6f8e1 639 * The Open vSwitch software switch now supports OpenFlow groups.
a5ae88ff
AA
640 - ovs-vswitchd.conf.db.5 man page will contain graphviz/dot
641 diagram only if graphviz package was installed at the build time.
54af97ad 642 - Support for Linux kernels up to 3.11
847108dc
AZ
643 - ovs-dpctl:
644 The "show" command also displays mega flow mask stats.
60e46251
BP
645 - ovs-ofctl:
646 * New command "ofp-parse-pcap" to dump OpenFlow from PCAP files.
1d5aaa61
BP
647 - ovs-controller has been renamed test-controller. It is no longer
648 packaged or installed by default, because too many users assumed
649 incorrectly that ovs-controller was a necessary or desirable part
650 of an Open vSwitch deployment.
afc9f547 651 - Added vlog option to export to a UDP syslog sink.
4227b221
BP
652 - ovsdb-client:
653 * The "monitor" command can now monitor all tables in a database,
654 instead of being limited to a single table.
e79a6c83
EJ
655 - The flow-eviction-threshold has been replaced by the flow-limit which is a
656 hard limit on the number of flows in the datapath. It defaults to 200,000
657 flows. OVS automatically adjusts this number depending on network
658 conditions.
e731d71b 659 - Added IPv6 support for active and passive socket communications.
b366c1f4
JP
660
661
2fdb1879 662v2.0.0 - 15 Oct 2013
9f31efc7 663---------------------
d27705ea
JP
664 - The ovs-vswitchd process is no longer single-threaded. Multiple
665 threads are now used to handle flow set up and asynchronous
666 logging.
0ad90c84 667 - OpenFlow:
75fa58f8
BP
668 * Experimental support for OpenFlow 1.1 (in addition to 1.2 and
669 1.3, which had experimental support in 1.10).
7395c052
NZ
670 * Experimental protocol support for OpenFlow 1.1+ groups. This
671 does not yet include an implementation in the Open vSwitch
672 software switch.
673 * Experimental protocol support for OpenFlow 1.2+ meters. This
674 does not yet include an implementation in the Open vSwitch
675 software switch.
0ad90c84
JR
676 * New support for matching outer source and destination IP address
677 of tunneled packets, for tunnel ports configured with the newly
e0eeeca5 678 added "remote_ip=flow" and "local_ip=flow" options.
ac923e91
JG
679 * Support for matching on metadata 'pkt_mark' for interacting with
680 other system components. On Linux this corresponds to the skb
681 mark.
fe8a1798 682 * Support matching, rewriting SCTP ports
ea401d9a
NM
683 - The Interface table in the database has a new "ifindex" column to
684 report the interface's OS-assigned ifindex.
81a114e5
BP
685 - New "check-oftest" Makefile target for running OFTest against Open
686 vSwitch. See README-OFTest for details.
380f49c4 687 - The flow eviction threshold has been moved to the Open_vSwitch table.
fb6de52c
GS
688 - Database names are now mandatory when specifying ovsdb-server options
689 through database paths (e.g. Private key option with the database name
690 should look like "--private-key=db:Open_vSwitch,SSL,private_key").
fef5244f 691 - Added ovs-dev.py, a utility script helpful for Open vSwitch developers.
9b764edf 692 - Support for Linux kernels up to 3.10
1ac0e975
BP
693 - ovs-ofctl:
694 * New "ofp-parse" for printing OpenFlow messages read from a file.
7395c052 695 * New commands for OpenFlow 1.1+ groups.
978427a5 696 - Added configurable flow caching support to IPFIX exporter.
37418c86 697 - Dropped support for Linux pre-2.6.32.
7c018033
BP
698 - Log file timestamps and ovsdb commit timestamps are now reported
699 with millisecond resolution. (Previous versions only reported
700 whole seconds.)
9f31efc7
JP
701
702
03c8f0b7 703v1.11.0 - 28 Aug 2013
d224e350 704---------------------
d445cc16
JP
705 - Support for megaflows, which allows wildcarding in the kernel (and
706 any dpif implementation that supports wildcards). Depending on
707 the flow table and switch configuration, flow set up rates are
708 close to the Linux bridge.
eeecce05
BP
709 - The "tutorial" directory contains a new tutorial for some advanced
710 Open vSwitch features.
df53d41c 711 - Stable bond mode has been removed.
1bda9b9e 712 - The autopath action has been removed.
a6ae068b
LJ
713 - New support for the data encapsulation format of the LISP tunnel
714 protocol (RFC 6830). An external control plane or manual flow
715 setup is required for EID-to-RLOC mapping.
b676167a 716 - OpenFlow:
0f3f3c3d
SH
717 * The "dec_mpls_ttl" and "set_mpls_ttl" actions from OpenFlow
718 1.1 and later are now implemented.
bd85dac1
AZ
719 * New "stack" extension for use in actions, to push and pop from
720 NXM fields.
a7b07d4c
BP
721 * The "load" and "set_field" actions can now modify the "in_port". (This
722 allows one to enable output to a flow's input port by setting the
723 in_port to some unused value, such as OFPP_NONE.)
186afbfe
BP
724 - ovs-dpctl:
725 * New debugging commands "add-flow", "mod-flow", "del-flow".
041e7168 726 * "dump-flows" now has a -m option to increase output verbosity.
bcd2633a
JP
727 - In dpif-based bridges, cache action translations, which can improve
728 flow set up performance by 80% with a complicated flow table.
ca03aae0 729 - New syslog format, prefixed with "ovs|", to be easier to filter.
f9ee9dcb
GS
730 - RHEL: Removes the default firewall rule that allowed GRE traffic to
731 pass through. Any users that relied on this automatic firewall hole
732 will have to manually configure it. The ovs-ctl(8) manpage documents
733 the "enable-protocol" command that can be used as an alternative.
90967e95
EJ
734 - New CFM demand mode which uses data traffic to indicate interface
735 liveness.
d224e350 736
b82b19e9 737v1.10.0 - 01 May 2013
4191f435 738---------------------
685e46da
BP
739 - Bridge compatibility support has been removed. Any uses that
740 rely on ovs-brcompatd will have to stick with Open vSwitch 1.9.x
741 or adapt to native Open vSwitch support (e.g. use ovs-vsctl instead
742 of brctl).
c4069512 743 - The maximum size of the MAC learning table is now configurable.
989fd548
JP
744 - With the Linux datapath, packets for new flows are now queued
745 separately on a per-port basis, so it should no longer be
746 possible for a large number of new flows arriving on one port to
747 prevent new flows from being processed on other ports.
43d18dc1
BP
748 - ovs-vsctl:
749 * Previously ovs-vsctl would retry connecting to the database forever,
750 causing it to hang if ovsdb-server was not running. Now, ovs-vsctl
751 only tries once by default (use --retry to try forever). This change
752 means that you may want to remove uses of --timeout to avoid hangs
753 in ovs-vsctl calls.
754 * Many "ovs-vsctl" database commands now accept an --if-exists option.
755 Please refer to the ovs-vsctl manpage for details.
e6024057 756 - OpenFlow:
d6123831
JP
757 - Experimental support for newer versions of OpenFlow. See
758 the "What versions of OpenFlow does Open vSwitch support?"
759 question in the FAQ for more details.
e6024057
JP
760 - The OpenFlow "dp_desc" may now be configured by setting the
761 value of other-config:dp-desc in the Bridge table.
762 - It is possible to request the OpenFlow port number with the
763 "ofport_request" column in the Interface table.
c9accf5b
BP
764 - The NXM flow_removed message now reports the OpenFlow table ID
765 from which the flow was removed.
3c23e920
JP
766 - Tunneling:
767 - New support for the VXLAN tunnel protocol (see the IETF draft here:
238bc978 768 http://tools.ietf.org/html/draft-mahalingam-dutt-dcops-vxlan-03).
3c23e920
JP
769 - Tunneling requires the version of the kernel module paired with
770 Open vSwitch 1.9.0 or later.
771 - Inheritance of the Don't Fragment bit in IP tunnels (df_inherit)
772 is no longer supported.
773 - Path MTU discovery is no longer supported.
ccd989e0
JG
774 - CAPWAP tunneling support removed.
775 - Tunnels with multicast destination ports are no longer supported.
e6024057
JP
776 - ovs-dpctl:
777 - The "dump-flows" and "del-flows" no longer require an argument
778 if only one datapath exists.
779 - ovs-appctl:
780 - New "vlog/disable-rate-limit" and "vlog/enable-rate-limit"
781 commands available allow control over logging rate limits.
782 - New "dpif/dump-dps", "dpif/show", and "dpif/dump-flows" command
783 that mimic the equivalent ovs-dpctl commands.
e6024057
JP
784 - The ofproto library is now responsible for assigning OpenFlow port
785 numbers. An ofproto implementation should assign them when
786 port_construct() is called.
787 - All dpif-based bridges of a particular type share a common
788 datapath called "ovs-<type>", e.g. "ovs-system". The ovs-dpctl
789 commands will now return information on that shared datapath. To
790 get the equivalent bridge-specific information, use the new
791 "ovs-appctl dpif/*" commands.
bedde04c
GS
792 - Backward-incompatible changes:
793 - Earlier Open vSwitch versions treated ANY as a wildcard in flow
794 syntax. OpenFlow 1.1 adds a port named ANY, which introduces a
795 conflict. ANY was rarely used in flow syntax, so we chose to
796 retire that meaning of ANY in favor of the OpenFlow 1.1 meaning.
3c23e920
JP
797 - Patch ports no longer require kernel support, so they now work
798 with FreeBSD and the kernel module built into Linux 3.3 and later.
29089a54 799 - New "sample" action.
f07ee64c 800
e5f77cc3 801
fdfe872d
JP
802v1.9.0 - 26 Feb 2013
803------------------------
72e8bf28
AA
804 - Datapath:
805 - Support for ipv6 set action.
806 - SKB mark matching and setting.
64807dfb 807 - support for Linux kernels up to 3.8
f6eb6b20
GL
808 - FreeBSD is now a supported platform, thanks to code contributions from
809 Gaetano Catalli, Ed Maste, and Giuseppe Lettieri.
b592e726 810 - ovs-bugtool: New --ovs option to report only OVS related information.
781dee08
BP
811 - New %t and %T log escapes to identify the subprogram within a
812 cooperating group of processes or threads that emitted a log message.
813 The default log patterns now include this information.
32455024 814 - OpenFlow:
e878338b
SH
815 - Allow bitwise masking for SHA and THA fields in ARP, SLL and TLL
816 fields in IPv6 neighbor discovery messages, and IPv6 flow label.
4cceacb9 817 - Adds support for writing to the metadata field for a flow.
3c23e920
JP
818 - Tunneling:
819 - The tunneling code no longer assumes input and output keys are
820 symmetric. If they are not, PMTUD needs to be disabled for
821 tunneling to work. Note this only applies to flow-based keys.
822 - New support for a nonstandard form of GRE that supports a 64-bit key.
823 - Tunnel Path MTU Discovery default value was set to 'disabled'.
824 This feature is deprecated and will be removed soon.
825 - Tunnel header caching removed.
c6100d92
BP
826 - ovs-ofctl:
827 - Commands and actions that accept port numbers now also accept keywords
828 that represent those ports (such as LOCAL, NONE, and ALL). This is
829 also the recommended way to specify these ports, for compatibility
830 with OpenFlow 1.1 and later (which use the OpenFlow 1.0 numbers
831 for these ports for different purposes).
2562714a 832 - ovs-dpctl:
4b3b8d8f
JP
833 - Support requesting the port number with the "port_no" option in
834 the "add-if" command.
2562714a
BP
835 - ovs-pki: The "online PKI" features have been removed, along with
836 the ovs-pki-cgi program that facilitated it, because of some
837 alarmist insecurity claims. We do not believe that these claims
838 are true, but because we do not know of any users for this
839 feature it seems better on balance to remove it. (The ovs-pki-cgi
840 program was not included in distribution packaging.)
341c4e59
BP
841 - ovsdb-server now enforces the immutability of immutable columns. This
842 was not enforced in earlier versions due to an oversight.
fd38af85
BP
843 - The following features are now deprecated. They will be removed no
844 earlier than February 2013. Please email dev@openvswitch.org with
845 concerns.
a8643e44 846 - Bridge compatibility.
fd38af85
BP
847 - Stable bond mode.
848 - The autopath action.
849 - Interface type "null".
850 - Numeric values for reserved ports (see "ovs-ofctl" note above).
85340733 851 - Tunnel Path MTU Discovery.
1280bf0e 852 - CAPWAP tunnel support.
f07ee64c
MM
853 - The data in the RARP packets can now be matched in the same way as the
854 data in ARP packets.
945cad7f 855
79f827fa 856
fdfe872d 857v1.8.0 - 26 Feb 2013
c8d5d22c 858------------------------
fdfe872d 859 *** Internal only release ***
c483d489 860 - New FAQ. Please send updates and additions!
f25d0cf3
BP
861 - Authors of controllers, please read the new section titled "Action
862 Reproduction" in DESIGN, which describes an Open vSwitch change in
863 behavior in corner cases that may affect some controllers.
2d8bdd8f
AA
864 - ovs-l3ping:
865 - A new test utility that can create L3 tunnel between two Open
866 vSwitches and detect connectivity issues.
5498c01f 867 - ovs-ofctl:
bdcc5925 868 - New --sort and --rsort options for "dump-flows" command.
5498c01f 869 - "mod-port" command can now control all OpenFlow config flags.
c08201d6 870 - OpenFlow:
ff0b06ee
BP
871 - Allow general bitwise masking for IPv4 and IPv6 addresses in
872 IPv4, IPv6, and ARP packets. (Previously, only CIDR masks
c08201d6
BP
873 were allowed.)
874 - Allow support for arbitrary Ethernet masks. (Previously, only
875 the multicast bit in the destination address could be individually
876 masked.)
969fc56c 877 - New field OXM_OF_METADATA, to align with OpenFlow 1.1.
0414d158
BP
878 - The OFPST_QUEUE request now reports an error if a specified port or
879 queue does not exist, or for requests for a specific queue on all
880 ports, if the specified queue does not exist on any port. (Previous
881 versions generally reported an empty set of results.)
2b07c8b1
BP
882 - New "flow monitor" feature to allow controllers to be notified of
883 flow table changes as they happen.
c93f9a78
EJ
884 - Additional protocols are not mirrored and dropped when forward-bpdu is
885 false. For a full list, see the ovs-vswitchd.conf.db man page.
38f7147c
EJ
886 - Open vSwitch now sends RARP packets in situations where it previously
887 sent a custom protocol, making it consistent with behavior of QEMU and
888 VMware.
969e46a2
AS
889 - All Open vSwitch programs and log files now show timestamps in UTC,
890 instead the local timezone, by default.
c8d5d22c
JP
891
892
3b4ab170 893v1.7.0 - 30 Jul 2012
dd1ba5b3 894------------------------
9b80f761
CW
895 - kernel modules are renamed. openvswitch_mod.ko is now
896 openvswitch.ko and brcompat_mod.ko is now brcompat.ko.
e9358af6 897 - Increased the number of NXM registers to 8.
22dd5cec 898 - Added ability to configure DSCP setting for manager and controller
f125905c
MM
899 connections. By default, these connections have a DSCP value of
900 Internetwork Control (0xc0).
3967a833
MM
901 - Added the granular link health statistics, 'cfm_health', to an
902 interface.
47284b1f
AA
903 - OpenFlow:
904 - Added support to mask nd_target for ICMPv6 neighbor discovery flows.
2be393ed
JP
905 - Added support for OpenFlow 1.3 port description (OFPMP_PORT_DESC)
906 multipart messages.
907 - ovs-ofctl:
908 - Added the "dump-ports-desc" command to retrieve port
909 information using the new port description multipart messages.
8d25d9a2
AA
910 - ovs-test:
911 - Added support for spawning ovs-test server from the client.
912 - Now ovs-test is able to automatically create test bridges and ports.
7393104d 913 - "ovs-dpctl dump-flows" now prints observed TCP flags in TCP flows.
22dd5cec 914 - Tripled flow setup performance.
a5f607bc
BP
915 - The "coverage/log" command previously available through ovs-appctl
916 has been replaced by "coverage/show". The new command replies with
917 coverage counter values, instead of logging them.
dd1ba5b3
JP
918
919
9d564cb2 920v1.6.1 - 25 Jun 2012
d0a8c2e0 921------------------------
9d564cb2
JP
922 - Allow OFPP_CONTROLLER as the in_port for packet-out messages.
923
924
925v1.6.0 - 24 Feb 2012
926------------------------
927 *** Internal only release ***
4df08875 928 - bonding
bdebeece
EJ
929 - LACP bonds no longer fall back to balance-slb when negotiations fail.
930 Instead they drop traffic.
4df08875
EJ
931 - The default bond_mode changed from SLB to active-backup, to protect
932 unsuspecting users from the significant risks of SLB bonds (which are
933 documented in vswitchd/INTERNALS).
bc1b010c
EJ
934 - Load balancing can be disabled by setting the bond-rebalance-interval
935 to zero.
73f33563
BP
936 - OpenFlow:
937 - Added support for bitwise matching on TCP and UDP ports.
938 See ovs-ofctl(8) for more information.
80d5aefd
BP
939 - NXM flow dumps now include times elapsed toward idle and hard
940 timeouts.
941 - Added an OpenFlow extension NXT_SET_ASYNC_CONFIG that allows
942 controllers more precise control over which OpenFlow messages they
943 receive asynchronously.
0e553d9c
BP
944 - New "fin_timeout" action.
945 - Added "fin_timeout" support to "learn" action.
a7349929
BP
946 - New Nicira action NXAST_CONTROLLER that offers additional features
947 over output to OFPP_CONTROLLER.
2c999774
BP
948 - When QoS settings for an interface do not configure a default queue
949 (queue 0), Open vSwitch now uses a default configuration for that
950 queue, instead of dropping all packets as in previous versions.
2a3e30b2
BP
951 - Logging:
952 - Logging to console and file will have UTC timestamp as a default for
953 all the daemons. An example of the default format is
954 2012-01-27T16:35:17Z. ovs-appctl can be used to change the default
955 format as before.
956 - The syntax of commands and options to set log levels was simplified,
957 to make it easier to remember.
254750ce
BP
958 - New support for limiting the number of flows in an OpenFlow flow
959 table, with configurable policy for evicting flows upon
960 overflow. See the Flow_Table table in ovs-vswitch.conf.db(5)
961 for more information.
9886b662
BP
962 - New "enable-async-messages" column in the Controller table. If set to
963 false, OpenFlow connections to the controller will initially have all
964 asynchronous messages disabled, overriding normal OpenFlow behavior.
1745cd08
BP
965 - ofproto-provider interface:
966 - "struct rule" has a new member "used" that ofproto implementations
967 should maintain by updating with ofproto_rule_update_used().
8f46c9bb
BP
968 - ovsdb-client:
969 - The new option --timestamp causes the "monitor" command to print
970 a timestamp with every update.
a7aa2d3c 971 - CFM module CCM broadcasts can now be tagged with an 802.1p priority.
d0a8c2e0
JP
972
973
a6492d91 974v1.5.0 - 01 Jun 2012
e68bfcfc 975------------------------
e729e793
JP
976 - OpenFlow:
977 - Added support for querying, modifying, and deleting flows
978 based on flow cookie when using NXM.
b4b7f827 979 - Added new NXM_PACKET_IN format.
f0fd1a17 980 - Added new NXAST_DEC_TTL action.
1eb85ef5
EJ
981 - ovs-ofctl:
982 - Added daemonization support to the monitor and snoop commands.
2a9537e2
BP
983 - ovs-vsctl:
984 - The "find" command supports new set relational operators
985 {=}, {!=}, {<}, {>}, {<=}, and {>=}.
e4476f74
BP
986 - ovsdb-tool now uses the typical database and schema installation
987 directories as defaults.
d1add61d
JP
988 - The default MAC learning timeout has been increased from 60 seconds
989 to 300 seconds. The MAC learning timeout is now configurable.
e68bfcfc
JP
990
991
ef13dc11 992v1.4.0 - 30 Jan 2012
b6a9a95b 993------------------------
50bf17cd 994 - Compatible with Open vSwitch kernel module included in Linux 3.3.
52a90c29
BP
995 - New "VLAN splinters" feature to work around buggy device drivers
996 in old Linux versions. (This feature is deprecated. When
997 broken device drivers are no longer in widespread use, we will
998 delete this feature.) See ovs-vswitchd.conf.db(5) for more
999 information.
fa8223b7
JP
1000 - OpenFlow:
1001 - Added ability to match on IPv6 flow label through NXM.
530180fd 1002 - Added ability to match on ECN bits in IPv4 and IPv6 through NXM.
a61680c6 1003 - Added ability to match on TTL in IPv4 and IPv6 through NXM.
530180fd 1004 - Added ability to modify ECN bits in IPv4.
a61680c6 1005 - Added ability to modify TTL in IPv4.
9d24de3b 1006 - ovs-vswitchd:
c06bba01
JP
1007 - Don't require the "normal" action to use mirrors. Traffic will
1008 now be properly mirrored for any flows, regardless of their
1009 actions.
9d24de3b 1010 - Track packet and byte statistics sent on mirrors.
733adf2a
LG
1011 - The sFlow implementation can now usually infer the correct agent
1012 device instead of having to be told explicitly.
f0a3aa2e
AA
1013 - ovs-appctl:
1014 - New "fdb/flush" command to flush bridge's MAC learning table.
0be6140a
AA
1015 - ovs-test:
1016 - A new distributed testing tool that allows one to diagnose performance
1017 and connectivity issues. This tool currently is not included in RH or
1018 Xen packages.
0fb42626 1019 - RHEL packaging now supports integration with Red Hat network scripts.
4c57c3bc
EJ
1020 - bonding:
1021 - Post 1.4.*, OVS will be changing the default bond mode from balance-slb
1022 to active-backup. SLB bonds carry significant risks with them
1023 (documented vswitchd/INTERNALS) which we want to prevent unsuspecting
1024 users from running into. Users are advised to update any scripts or
1025 configuration which may be negatively impacted by explicitly setting
1026 the bond mode which they want to use.
b6a9a95b 1027
0be6140a 1028
ddc29387 1029v1.3.0 - 09 Dec 2011
3e60856b 1030------------------------
f694937d
EJ
1031 - OpenFlow:
1032 - Added an OpenFlow extension which allows the "output" action to accept
1033 NXM fields.
75a75043 1034 - Added an OpenFlow extension for flexible learning.
d2c0fed9 1035 - Bumped number of NXM registers from four to five.
d5e1e5ed 1036 - ovs-appctl:
ae75dae3
JP
1037 - New "version" command to determine version of running daemon.
1038 - If no argument is provided for "cfm/show", displays detailed
1039 information about all interfaces with CFM enabled.
5dab8ece
JP
1040 - If no argument is provided for "lacp/show", displays detailed
1041 information about all ports with LACP enabled.
10500639
BP
1042 - ovs-dpctl:
1043 - New "set-if" command to modify a datapath port's configuration.
29901626
BP
1044 - ovs-vswitchd:
1045 - The software switch now supports 255 OpenFlow tables, instead
1046 of just one. By default, only table 0 is consulted, but the
1047 new NXAST_RESUBMIT_TABLE action can look up in additional
1048 tables. Tables 128 and above are reserved for use by the
1049 switch itself; please use only tables 0 through 127.
21f7563c 1050 - Add support for 802.1D spanning tree (STP).
7257b535
BP
1051 - Fragment handling extensions:
1052 - New OFPC_FRAG_NX_MATCH fragment handling mode, in which L4
1053 fields are made available for matching in fragments with
1054 offset 0.
1055 - New NXM_NX_IP_FRAG match field for matching IP fragments (usable
1056 via "ip_frag" in ovs-ofctl).
1057 - New ovs-ofctl "get-frags" and "set-frags" commands to get and set
1058 fragment handling policy.
2f4bc10d
BP
1059 - CAPWAP tunneling now supports an extension to transport a 64-bit key.
1060 By default it remains compatible with the old version and other
c87112ca 1061 standards-based implementations.
17411ecf
JG
1062 - Flow setups are now processed in a round-robin manner across ports
1063 to prevent any single client from monopolizing the CPU and conducting
1064 a denial of service attack.
ecac4ebf
BP
1065 - Added support for native VLAN tagging. A new "vlan_mode"
1066 parameter can be set for "port". Possible values: "access",
1067 "trunk", "native-tagged" and "native-untagged".
023e1e0a 1068 - test-openflowd has been removed. Please use ovs-vswitchd instead.
3e60856b 1069
5e9c5b61 1070v1.2.0 - 03 Aug 2011
b78f6b77 1071------------------------
1a142ced
JP
1072 - New "ofproto" abstraction layer to ease porting to hardware
1073 switching ASICs.
1074 - Packaging for Red Hat Enterprise Linux 5.6 and 6.0.
1075 - Datapath support for Linux kernels up to 3.0.
1076 - OpenFlow:
1077 - New "bundle" and "bundle_load" action extensions.
1078 - Database:
1079 - Implement table unique constraints.
1080 - Support cooperative locking between callers.
1081 - ovs-dpctl:
1082 - New "-s" option for "show" command prints packet and byte
1083 counters for each port.
c4ea79bf
BP
1084 - ovs-ofctl:
1085 - New "--readd" option for "replace-flows".
9b1735a7
BP
1086 - ovs-vsctl:
1087 - New "show" command to print an overview of configuration.
1a142ced 1088 - New "comment" command to add remark that explains intentions.
2b01925c 1089 - ovs-brcompatd has been rewritten to fix long-standing bugs.
045b2e5c
BP
1090 - ovs-openflowd has been renamed test-openflowd and moved into the
1091 tests directory. Its presence confused too many users. Please
1092 use ovs-vswitchd instead.
1a142ced
JP
1093 - New ovs-benchmark utility to test flow setup performance.
1094 - A new log level "off" has been added. Configuring a log facility
1095 "off" prevents any messages from being logged to it. Previously,
1096 "emer" was effectively "off" because no messages were ever logged at
1097 level "emer". Now, errors that cause a process to exit are logged
1098 at "emer" level.
8a2d6596
BP
1099 - "configure" option --with-l26 has been renamed --with-linux, and
1100 --with-l26-source has been renamed --with-linux-source. The old
1101 names will be removed after the next release, so please update
1102 your scripts.
22bcc0e7
JG
1103 - The "-2.6" suffix has been dropped from the datapath/linux-2.6 and
1104 datapath/linux-2.6/compat-2.6 directories.
b78f6b77
BP
1105 - Feature removals:
1106 - Dropped support for "tun_id_from_cookie" OpenFlow extension.
0be6140a 1107 Please use the extensible match extensions instead.
93b8df38
EJ
1108 - Removed the Maintenance_Point and Monitor tables in an effort
1109 to simplify 802.1ag configuration.
1a142ced
JP
1110 - Performance and scalability improvements
1111 - Bug fixes
b78f6b77 1112
d4da3acc
JP
1113v1.1.0 - 05 Apr 2011
1114------------------------
1115 - Ability to define policies over IPv6
1116 - LACP
1117 - 802.1ag CCM
1118 - Support for extensible match extensions to OpenFlow
1119 - QoS:
1120 - Support for HFSC qdisc.
1121 - Queue used by in-band control can now be configured.
1122 - Kernel:
1123 - Kernel<->userspace interface has been reworked and should be
1124 close to a stable ABI now.
1125 - "Port group" concept has been dropped.
1126 - GRE over IPSEC tunnels
1127 - Bonding:
1128 - New active backup bonding mode.
1129 - New L4 hashing support when LACP is enabled.
1130 - Source MAC hash now includes VLAN field also.
1131 - miimon support.
1132 - Greatly improved handling of large flow tables
1133 - ovs-dpctl:
1134 - "show" command now prints full vport configuration.
1135 - "dump-groups" command removed since kernel support for
1136 port groups was dropped.
1137 - ovs-vsctl:
1138 - New commands for working with the new Managers table.
1139 - "list" command enhanced with new formatting options and --columns
1140 option.
1141 - "get" command now accepts new --id option.
1142 - New "find" command.
1143 - ovs-ofctl:
1144 - New "queue-stats" command for printing queue stats.
1145 - New commands "replace-flows" and "diff-flows".
1146 - Commands to add and remove flows can now read from files.
1147 - New --flow-format option to enable or disable NXM.
1148 - New --more option to increase OpenFlow message verbosity.
1149 - Removed "tun-cookie" command, which is no longer useful.
1150 - ovs-controller enhancements for testing various features.
1151 - New ovs-vlan-test command for testing for Linux kernel driver VLAN
1152 bugs. New ovs-vlan-bug-workaround command for enabling and
1153 disabling a workaround for these driver bugs.
1154 - OpenFlow support:
35d25d44 1155 - "Resubmit" actions now update flow statistics.
d4da3acc
JP
1156 - New "register" extension for use in matching and actions, via NXM.
1157 - New "multipath" experimental action extension.
1158 - New support for matching multicast Ethernet frames, via NXM.
1159 - New extension for OpenFlow vendor error codes.
1160 - New extension to set the QoS output queue without actually
1161 sending to an output port.
1162 - Open vSwitch now reports a single flow table, instead of
1163 separate hash and wildcard tables. This better models the
1164 current implementation.
1165 - New experimental "note" action.
1166 - New "ofproto/trace" ovs-appctl command and associated utilities
1167 to ease debugging complex flow tables.
1168 - Database:
1169 - Schema documentation now includes an entity-relationship diagram.
1170 - The database is now garbage collected. In most tables,
1171 unreferenced rows will be deleted automatically.
1172 - Many tables now include statistics updated periodically by
1173 ovs-vswitchd or ovsdb-server.
1174 - Every table now has an "external-ids" column for use by OVS
1175 integrators.
1176 - There is no default controller anymore. Each bridge must have its
1177 controller individually specified.
1178 - The "fail-mode" is now a property of a Bridge instead of a Controller.
1179 - New versioning and checksum features.
1180 - New Managers table and manager_options column in Open_vSwitch table
1181 for specifying managers. The old "managers" column in the
1182 Open_vSwitch table has been removed.
1183 - Many "name" columns are now immutable.
1184 - Feature removals:
1185 - Dropped support for XenServer pre-5.6.100.
1186 - Dropped support for Linux pre-2.6.18.
1187 - Dropped controller discovery support.
1188 - Dropped "ovs-ofctl status" and the OpenFlow extension that it used.
1189 Statistics reporting in the database is a rough equivalent.
1190 - Dropped the "corekeeper" package (now separate, at
1191 http://openvswitch.org/cgi-bin/gitweb.cgi?p=corekeeper).
1192 - Performance and scalability improvements
1193 - Bug fixes
1194
d5905136
JP
1195v1.1.0pre2 - 13 Sep 2010
1196------------------------
1197 - Bug fixes
1198
fdf20378
JP
1199v1.1.0pre1 - 31 Aug 2010
1200------------------------
476d56f5
JP
1201 - OpenFlow 1.0 slicing (QoS) functionality
1202 - Python bindings for configuration database (no write support)
1203 - Performance and scalability improvements
1204 - Bug fixes
1205
b9b0865a
JP
1206v1.0.1 - 31 May 2010
1207--------------------
1208 - New "patch" interface type
1209 - Bug fixes
1210
7c284ac4
JP
1211v1.0.0 - 15 May 2010
1212--------------------
1213 - Configuration database with remote management
1214 - OpenFlow 1.0
1215 - GRE tunneling
1216 - Support for XenServer 5.5 and 5.6
1217 - Performance and scalability improvements
1218 - Bug fixes
1219
2f0a1f42
JP
1220v0.99.2 - 18 Feb 2010
1221---------------------
1222 - Bug fixes
1223
b84a0589
JP
1224v0.99.1 - 25 Jan 2010
1225---------------------
1226 - Add support for sFlow(R)
1227 - Make headers compatible with C++
1228 - Bug fixes
1229
b7f22a6a
JP
1230v0.99.0 - 14 Jan 2010
1231---------------------
1232 - User-space forwarding engine
1233 - Bug fixes
35d25d44 1234
6d735676
JP
1235v0.90.7 - 29 Nov 2009
1236---------------------
1237 - Add support for NetFlow active timeouts
1238 - Bug fixes
b7f22a6a 1239
ef5925df
JP
1240v0.90.6 - 6 Oct 2009
1241--------------------
1242 - Bug fixes
1243
3c708eb8 1244v0.90.5 - 21 Sep 2009
30ee1c4d
JP
1245---------------------
1246 - Generalize in-band control to more diverse network setups
1247 - Bug fixes