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