Creating vlan bindings upfront
[netvirt.git] / docs / user-guide / support.rst
1 Support
2 =======
3 .. contents:: Table of Contents
4    :depth: 2
5
6 Verified Combinations
7 ----------------------
8 This section describes different combinations of OpenStack and Open vSwitch
9 versions that are expected to work with with different OpenDaylight versions.
10 Using combinations outside this list may work but have not been verified.
11
12 .. note::
13    A verified combination is defined as a combinations that is actively tested
14    and maintained. OpenDaylight, OpenStack and Open vSwitch are very active and
15    quickly adding new features that makes it difficult to verify all the different
16    release combinations. Different combinations are likely to work but support will be
17    limited.
18
19 The following table details the expected supported combinations.
20
21 .. csv-table:: Supported Version Matrix
22    :header: OpenDaylight, OpenStack, Open vSwitch, Sync, Notes
23    :widths: 12, 12, 12, 5, 40
24
25    Carbon, Ocata, 2.7,, "Combination drops when Pike releases"
26    Carbon, Pike, 2.8, S,
27    Nitrogen, Ocata, 2.7,, "Combination drops when Pike releases"
28    Nitrogen, Pike, 2.9, S,
29    Oxygen, Pike, 2.8,,"Combination drops when Queens releases"
30    Oxygen, Queens, 2.9, S,
31    Fluorine, Queens, 2.9,, "Combination drops when Rocky releases"
32    Fluorine, Rocky, 2.11, S,
33    Neon, Rocky, 2.11,, "Combination drops when Stein releases"
34    Neon, Stein, 2.11, S,
35    Sodium, Rocky, 2.11,, "Combination drops when Train releases"
36    Sodium, Train, 2.11, S,
37
38 * (S): in the Sync column indicates the final supported combination for that
39   OpenDaylight release.
40 * Differing release schedules will lead to short-lived combinations that will
41   drop as the releases line up. An example is with Carbon that releases
42   before Pike so for a period of time Carbon is supported with Ocata.
43 * The current OpenDaylight version and the previous will be supported.
44   Boron support will drop when Nitrogen releases; Carbon support will drop
45   when Oxygen releases.
46
47 Open vSwitch Kernel and DPDK Modes
48 ----------------------------------
49 The table below lists the Open vSwitch requirements for the Carbon release.
50
51 .. csv-table:: Kernel and DPDK Modes
52    :header: "Feature", "OVS 2.6 kernel mode", "OVS 2.6 dpdk mode"
53
54    Conntrack - security groups, yes, yes
55    Conntrack - NAT, yes, no (target 2.8*)
56    Security groups stateful, yes (conntrack), yes(conntrack)
57    Security groups learn, yes (but not needed), yes (but not needed)
58    IPV4 NAT (without pkt punt to controller), yes (conntrack), no (target 2.8*)
59    IPV4 NAT (with pkt punt to controller), not needed, yes (until 2.8*)
60
61 (*) support is tentatively scheduled for Open vSwitch 2.8