summaryrefslogtreecommitdiff
path: root/Documentation
Commit message (Collapse)AuthorAgeFilesLines
* ovs-sim: Convert documentation to RST format.Ben Pfaff2018-05-254-1/+229
| | | | | Signed-off-by: Ben Pfaff <blp@ovn.org> Acked-by: Justin Pettit <jpettit@ovn.org>
* erspan: update NEWS and FAQ.William Tu2018-05-251-2/+18
| | | | | | | | | Update Documentation/faq/configuration.rst about ERSPAN and Update NEWS. Cc: Greg Rose <gvrose8192@gmail.com> Signed-off-by: William Tu <u9012063@gmail.com> Signed-off-by: Ben Pfaff <blp@ovn.org>
* dpdk: reflect status and version in the databaseAaron Conole2018-05-252-6/+29
| | | | | | | | | | | | | | | | The normal way of retrieving the running DPDK status involves parsing log files and issuing various incantations of ovs-vsctl and ovs-appctl commands to determine whether the rte_eal_init successfully started. This commit adds two new records to reflect the dpdk version, and the dpdk initialization status. To support this, the other_config:dpdk-init configuration block supports the 'true' and 'try' keywords now, instead of just 'true'. Signed-off-by: Aaron Conole <aconole@redhat.com> Acked-by: Kevin Traynor <ktraynor@redhat.com> Signed-off-by: Ian Stokes <ian.stokes@intel.com>
* Configurable Link State Change (LSC) detection modeRóbert Mulik2018-05-111-0/+24
| | | | | | | | | | | It is possible to set LSC detection mode to polling or interrupt mode for DPDK interfaces. The default is polling mode. To set interrupt mode, option dpdk-lsc-interrupt has to be set to true. For detailed description and usage see the dpdk install documentation. Signed-off-by: Robert Mulik <robert.mulik@ericsson.com> Signed-off-by: Ian Stokes <ian.stokes@intel.com>
* faq: Document DPDK version maintenance.Kevin Traynor2018-05-111-0/+16
| | | | | | | | | | The faq already shows the DPDK versions that were used with each OVS version. Give information about DPDK stable and LTS releases, so the user can understand if those versions are maintained. Signed-off-by: Kevin Traynor <ktraynor@redhat.com> Signed-off-by: Ian Stokes <ian.stokes@intel.com>
* dpdk: Use DPDK 17.11.2 release.Kevin Traynor2018-05-113-9/+9
| | | | | | | | | Modify travis linux build script to use the latest DPDK stable release 17.11.2. Update docs for latest DPDK stable releases. Signed-off-by: Kevin Traynor <ktraynor@redhat.com> Signed-off-by: Ian Stokes <ian.stokes@intel.com>
* faq: Start an OVN FAQ by giving a rationale for how it uses tunnels.Ben Pfaff2018-05-103-0/+92
| | | | | Signed-off-by: Ben Pfaff <blp@ovn.org> Acked-by: Aaron Conole <aconole@redhat.com>
* Doc: Fix commands not being shown in code blocksaxel@tripier.fr2018-05-091-3/+3
| | | | | | | | | Some commands are not shown in code blocks in the Advances Features tutorial, they are shown as variable width text because of a missing ":" to designate them as code blocks. Signed-off-by: Axel Tripier <axel@tripier.fr> Signed-off-by: Ben Pfaff <blp@ovn.org>
* Doc: Fix binary representation in Faucet tutorialaxel@tripier.fr2018-05-091-2/+2
| | | | | | | | The binary representation of 80 and 8080 are switched in the Faucet tutorial. Signed-off-by: Axel Tripier <axel@tripier.fr> Signed-off-by: Ben Pfaff <blp@ovn.org>
* utilities: Add some GDB macros for ovs-vswitchdEelco Chaudron2018-05-091-0/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | This commit adds basic GDB macro's for ovs-vswitchd: - ovs_dump_bridge [ports|wanted] - ovs_dump_bridge_ports <struct bridge *> - ovs_dump_dp_netdev [ports] - ovs_dump_dp_netdev_ports <struct dp_netdev *> - ovs_dump_netdev These dump functions show limited info, but you can simply cut/paste the address and get the full structure info. For example: (gdb) ovs_dump_netdev (struct netdev *) 0x555771ed89e0: name = ovs-netdev , auto_classified = false, netdev_class = 0x5557714413c0 <netdev_tap_class> (struct netdev *) 0x555771fc62a0: name = ovs_pvp_br0 , auto_classified = false, netdev_class = 0x5557714413c0 <netdev_tap_class> (struct netdev *) 0x555771fc9660: name = vnet0 , auto_classified = true , netdev_class = 0x555771445e00 <netdev_linux_class> (struct netdev *) 0x555771fc78d0: name = virbr0 , auto_classified = true , netdev_class = 0x555771445e00 <netdev_linux_class> (struct netdev *) 0x7fbefffb5540: name = dpdk0 , auto_classified = false, netdev_class = 0x5557714419e0 <dpdk_class> (struct netdev *) 0x555771fc98b0: name = em3 , auto_classified = true , netdev_class = 0x555771445e00 <netdev_linux_class> (struct netdev *) 0x7fbea0a31c40: name = vhost0 , auto_classified = false, netdev_class = 0x555771442040 <dpdk_vhost_client_class> (gdb) p *((struct netdev *) 0x7fbefffb5540) $1 = {name = 0x555771ecef70 "dpdk0", netdev_class = 0x5557714419e0 <dpdk_class>, auto_classified = false, mtu_user_config = true, ref_cnt = 2, change_seq = 12, reconfigure_seq = 0x555771ecf2e0, last_reconfigure_seq = 110, n_txq = 2, n_rxq = 1, node = 0x555771efafe0, saved_flags_list = {prev = 0x7fbefffb5580, next = 0x7fbefffb5580}} Signed-off-by: Eelco Chaudron <echaudro@redhat.com> Signed-off-by: Ben Pfaff <blp@ovn.org>
* Merge branch 'dpdk_merge' of https://github.com/istokes/ovs into HEADBen Pfaff2018-04-3018-538/+987
|\
| * tests: Add system-dpdk-testsuiteMarcin Rybka2018-04-211-0/+23
| | | | | | | | | | | | | | | | | | | | | | | | New OVS-DPDK testsuite, which can be launched via `make check-dpdk`, tests OVS using a DPDK datapath. The testsuite contains already initial tests: 1. EAL init 2. Add standard DPDK PHY port 3. Add vhost-user-client port Signed-off-by: Marcin Rybka <marcinx.rybka@intel.com> Signed-off-by: Ian Stokes <ian.stokes@intel.com>
| * docs: Clarify changes in Rx queue allocationStephen Finucane2018-04-211-7/+10
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Two mistakes here: - Automatic assignment of Rx queues to PMD threads has always existed - it was simply switched from round-robin allocation to utilization-based allocation - The above, along with the 'pmd-rxq-rebalance' command, was added in OVS 2.9.0 - not OVS 2.8.0 - while the 'pmd-rxq-show' command was added in OVS 2.6.0 and modified in OVS 2.9.0 Correct both of these and modify the NEWS entry for this to clarify things a little (it took a bit of git spelunking and bothering people on IRC to figure out). Signed-off-by: Stephen Finucane <stephen@that.guru> Cc: Kevin Traynor <ktraynor@redhat.com> Cc: Ian Stokes <ian.stokes@intel.com> Acked-by: Kevin Traynor <ktraynor@redhat.com> Signed-off-by: Ian Stokes <ian.stokes@intel.com>
| * doc: Add "jumbo frames" topic documentStephen Finucane2018-04-216-49/+90
| | | | | | | | | | | | | | We include references from the physical and vhost-user interface guides. Signed-off-by: Stephen Finucane <stephen@that.guru> Signed-off-by: Ian Stokes <ian.stokes@intel.com>
| * doc: Move "pdump" guide to its own documentStephen Finucane2018-04-214-39/+69
| | | | | | | | | | | | | | | | Yet another section that's far too detailed for someone getting started with DPDK in OVS. Split it out. Signed-off-by: Stephen Finucane <stephen@that.guru> Signed-off-by: Ian Stokes <ian.stokes@intel.com>
| * doc: Add "bridge" topic documentStephen Finucane2018-04-218-60/+126
| | | | | | | | | | | | | | | | This details configuration steps that apply to the entire bridge, rather than individual ports. Signed-off-by: Stephen Finucane <stephen@that.guru> Signed-off-by: Ian Stokes <ian.stokes@intel.com>
| * doc: Move "QoS" guide to its own documentStephen Finucane2018-04-215-42/+82
| | | | | | | | | | | | | | Again, this stuff is too detailed for a high-level howto. Signed-off-by: Stephen Finucane <stephen@that.guru> Signed-off-by: Ian Stokes <ian.stokes@intel.com>
| * doc: Add "vdev" topic documentStephen Finucane2018-04-214-29/+63
| | | | | | | | | | | | | | | | | | These are separate things from physical, ring and vhost-user interfaces and deserve their own documents. A couple of small typos are fixed along the way. Signed-off-by: Stephen Finucane <stephen@that.guru> Signed-off-by: Ian Stokes <ian.stokes@intel.com>
| * doc: Move additional sections to "physical ports" docStephen Finucane2018-04-213-90/+110
| | | | | | | | | | | | | | | | | | | | The "hotplugging", "flow control", and "Rx checksum offload" sections only apply to 'dpdk' ports and are too detailed to include in a high-level howto. Move them, reworking some aspects of this in the process. Signed-off-by: Stephen Finucane <stephen@that.guru> Signed-off-by: Ian Stokes <ian.stokes@intel.com>
| * doc: Add "PMD" topic documentStephen Finucane2018-04-216-95/+183
| | | | | | | | | | | | | | | | | | | | This continues the breakup of the huge DPDK "howto" into smaller components. There are a couple of related changes included, such as using "Rx queue" instead of "rxq" and noting how Tx queues cannot be configured. Signed-off-by: Stephen Finucane <stephen@that.guru> Signed-off-by: Ian Stokes <ian.stokes@intel.com>
| * doc: Add an overview of the 'dpdk' portStephen Finucane2018-04-214-1/+118
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | These ports are used to allow ingress/egress from the host and are therefore _reasonably_ important. However, there is no clear overview of what these ports actually are or why things are done the way they are. Start closing this gap by providing a standalone example of using these ports along with a little more detailed overview of the binding process. There is additional cleanup to be done for the DPDK howto, but that will be done separately. We enable the TODO directive so we can actually start calling out some TODOs. Signed-off-by: Stephen Finucane <stephen@that.guru> Signed-off-by: Ian Stokes <ian.stokes@intel.com>
| * docs: Fix urls in index.rst.Ian Stokes2018-04-211-109/+105
| | | | | | | | | | | | | | | | | | | | | | This patch prepends 'www' to openvswitch urls in index.rst. Without this make check-docs fails when verifying url liveness. Also remove url referencing ovsdb-server(5) as these are no longer accessible. Cc: Stephen Finucane <stephen@that.guru> Fixes: 4f6ec357c ("doc: Populate 'ref' section") Signed-off-by: Ian Stokes <ian.stokes@intel.com> Acked-by: Stephen Finucane <stephen@that.guru>
| * docs: Fix sphinx urls.Ian Stokes2018-04-212-3/+4
| | | | | | | | | | | | | | | | | | | | | | Update dead url links for sphinx documentation to avoid make check-docs failing. Cc: Stephen Finucane <stephen@that.guru> Fixes: 26ea2d409 ("docs: Add writing guide") Fixes: 73c76b447 ("doc: Add info on building documentation") Signed-off-by: Ian Stokes <ian.stokes@intel.com> Acked-by: Stephen Finucane <stephen@that.guru>
| * docs: Fix style guide url in DocumentationStyle.rst.Ian Stokes2018-04-211-2/+2
| | | | | | | | | | | | | | | | | | | | | | The link used for IBM Style Guide is no longer valid. As there is no longer a valid link via redbooks remove the url to avoid make check-docs failing. Cc: Stephen Finucane <stephen@that.guru> Fixes: 26ea2d409 ("docs: Add writing guide") Signed-off-by: Ian Stokes <ian.stokes@intel.com> Acked-by: Stephen Finucane <stephen@that.guru>
| * docs: Fix sflow documentation url and markup.Ian Stokes2018-04-211-3/+6
| | | | | | | | | | | | | | | | | | | | | | | | The link url link for the blog in sflow documentation causes make check-docs to fail with a broken link warning. Fix this by correcting the url address. Also use correct markup for note regarding the configuration of sflow. CC: Stephen Finucane <stephen@that.guru> Fixes: 198c5d3d0 ("doc: Add sFlow cookbook from website") Signed-off-by: Ian Stokes <ian.stokes@intel.com> Acked-by: Stephen Finucane <stephen@that.guru>
| * dpdk docs: Drop file share in libvirt config.Tiago Lam2018-04-211-15/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | When explaining on how to add vhost-user ports to a guest, using libvirt, the following piece of configuration is used: <disk type='dir' device='disk'> <driver name='qemu' type='fat'/> <source dir='/usr/src/dpdk-stable-17.11.1'/> <target dev='vdb' bus='virtio'/> <readonly/> </disk> This is used to facilitate sharing of a DPDK directory between the host and the guest. However, for this to work selinux also needs to be configured (or disabled). Furthermore, if one is using Ubuntu, libvirtd would need to be added to complain only in AppArmor. Instead, in [1] it is advised to use wget to get the DPDK sources over the internet, which avoids this differentiation. Thus, we drop this piece of configuration here as well and keep the example configuration as simple as possible. This has been verified on both a Fedora 27 image and a Ubuntu 16.04 LTS image. [1] http://docs.openvswitch.org/en/latest/topics/dpdk/vhost-user/#dpdk-in-the-guest Signed-off-by: Tiago Lam <tiago.lam@intel.com> Acked-by: Stephen Finucane <stephen@that.guru> Signed-off-by: Ian Stokes <ian.stokes@intel.com>
| * dpdk docs: Drop qemu-kvm for qemu-system-x86_64.Tiago Lam2018-04-211-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | When explaining on how to add vhost-user ports to a guest, using libvirt, point to the qemu-system-x86_64 binary by default, instead of using qemu-kvm. The latter has been made obsolete and dropped from a number of distributions (although it is still available on Fedora). This has been verified on both a Fedora 27 image and a Ubuntu 16.04 LTS image. Signed-off-by: Tiago Lam <tiago.lam@intel.com> Acked-by: Aaron Conole <aconole@redhat.com> Signed-off-by: Ian Stokes <ian.stokes@intel.com>
| * netdev-dpdk: fix MAC address in port addr exampleMarcelo Ricardo Leitner2018-04-211-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | The MAC address is always 6-bytes long, never 7. The extra :01 and :02 doesn't belong in there as it doesn't mean selecting one port or another. Instead, use an incrementing MAC address, which is what usually happens on such cards. See-also: http://www.dpdk.org/ml/archives/dev/2018-April/094976.html Fixes: 5e7588186839 ("netdev-dpdk: fix port addition for ports sharing same PCI id") Signed-off-by: Marcelo Ricardo Leitner <marcelo.leitner@gmail.com> Signed-off-by: Ian Stokes <ian.stokes@intel.com>
* | ovsdb.7: Clarify description of OVSDB.Ben Pfaff2018-04-261-6/+5
| | | | | | | | | | | | | | | | | | A reader reported that "network database system" made it sound like OVSDB was specialized for databases about networks. It's not, it's just accessible over the network. Signed-off-by: Ben Pfaff <blp@ovn.org> Acked-by: Justin Pettit <jpettit@ovn.org>
* | poc: update the documentationAaron Conole2018-04-241-10/+11
|/ | | | | | | | Misc. fixes to the Proof of Concepts section to help render the information a bit nicer. Signed-off-by: Aaron Conole <aconole@redhat.com> Acked-by: Ansis Atteka <aatteka@ovn.org>
* netns: Add documentation and update NEWS.Flavio Leitner2018-04-133-0/+70
| | | | | | | | Create a document to describe the how it works and known limitations and update the NEWS accordingly. Signed-off-by: Flavio Leitner <fbl@sysclose.org> Signed-off-by: Ben Pfaff <blp@ovn.org>
* Update docker run commandFrédéric2018-04-031-1/+1
| | | | | | | Faucet config is now in: /etc/faucet/ and log in: /var/log/faucet/ Signed-off-by: Frédéric Tobias Christ <fchrist@live.de> Signed-off-by: Ben Pfaff <blp@ovn.org>
* Merge branch 'dpdk_merge' of https://github.com/istokes/ovs into HEADBen Pfaff2018-03-313-33/+14
|\
| * dpdk: Use DPDK 17.11.1 release.Ian Stokes2018-03-213-33/+11
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Modify docs and travis linux build script to use the DPDK 17.11.1 release branch to benefit from most recent bug fixes. There are no new features introduced in the DPDK release, only back ported bug fixes. For completeness these bug fixes have been documented under the 17.11.1 section in the link below. http://dpdk.org/doc/guides-17.11/rel_notes/release_17_11.html#id1 Signed-off-by: Ian Stokes <ian.stokes@intel.com> Acked-by: Kevin Traynor <ktraynor@redhat.com>
| * Documentation: Add note about dpdkvhostuser and IOMMU.Kevin Traynor2018-03-211-0/+3
| | | | | | | | | | | | | | | | | | | | | | The docs describe IOMMU support for dpdkvhostuserclient ports, but it is not mentioned in the section about dpdkvhostuser ports. Add an explicit note to say IOMMU is not supported for dpdkvhostuser ports. CC: Maxime Coquelin <maxime.coquelin@redhat.com> Signed-off-by: Kevin Traynor <ktraynor@redhat.com> Signed-off-by: Ian Stokes <ian.stokes@intel.com>
* | ovsdb: Introduce experimental support for clustered databases.Ben Pfaff2018-03-242-38/+398
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This commit adds support for OVSDB clustering via Raft. Please read ovsdb(7) for information on how to set up a clustered database. It is simple and boils down to running "ovsdb-tool create-cluster" on one server and "ovsdb-tool join-cluster" on each of the others and then starting ovsdb-server in the usual way on all of them. One you have a clustered database, you configure ovn-controller and ovn-northd to use it by pointing them to all of the servers, e.g. where previously you might have said "tcp:1.2.3.4" was the database server, now you say that it is "tcp:1.2.3.4,tcp:5.6.7.8,tcp:9.10.11.12". This also adds support for database clustering to ovs-sandbox. Acked-by: Justin Pettit <jpettit@ovn.org> Tested-by: aginwala <aginwala@asu.edu> Signed-off-by: Ben Pfaff <blp@ovn.org>
* | ovsdb: Add support for online schema conversion.Ben Pfaff2018-03-242-2/+44
| | | | | | | | | | | | | | | | | | | | | | With this change, "ovsdb-client convert" can be used to convert a database from one schema to another without taking the database offline. This can be useful to minimize downtime for a database during a software upgrade. Signed-off-by: Ben Pfaff <blp@ovn.org> Acked-by: Justin Pettit <jpettit@ovn.org>
* | ovsdb-server: Add new RPC "set_db_change_aware".Ben Pfaff2018-03-241-0/+43
| | | | | | | | | | | | | | | | | | | | | | | | | | The _Server database recently added to ovsdb-server can be used to dump out information about databases, but monitoring updates to _Server is not yet very useful because for historical reasons ovsdb-server drops all of its OVSDB connections whenever databases are added or removed or otherwise change in some major way. It is not a good idea to change this behavior for all clients, because some of them rely on it, but this commit introduces a new RPC that allows clients that understand _Server to suppress the connection-closing behavior. Signed-off-by: Ben Pfaff <blp@ovn.org>
* | ovsdb-server: Add support for a built-in _Server database.Ben Pfaff2018-03-241-0/+4
|/ | | | | | | | | | | | | | | | | | | | | The _Server database is valuable primarily because it provides database clients a way to find out the details of changes to databases, schemas, etc. in a granular, natural way. Until now, the only way that the server could notify clients about these kinds of changes was to close the session; when the client reconnects, it is expected to reassess the server's state. One way to provide this kind of granular information would be to add specific JSON-RPC requests to obtain notifications for different kinds of changes, but since ovsdb-server already provides granular and flexible notification support for databases, using a database for the purpose is convenient and avoids duplicating functionality. Initially this database only reports databases' names and schemas, but when clustering support is added in a later commit it will also report important aspects of clustering and cluster status. Thus, this database also reduces the need to add JSON-RPC calls to retrieve information about new features. Signed-off-by: Ben Pfaff <blp@ovn.org>
* Clean up some minor spelling and typos.Justin Pettit2018-03-1422-46/+46
| | | | | Signed-off-by: Justin Pettit <jpettit@ovn.org> Acked-by: Ben Pfaff <blp@ovn.org>
* datapath-windows: Support to selectively compile targetsShashank Ram2018-03-021-1/+4
| | | | | | | | | | | | | | | | | Adds support to selectively compile kernel driver for target versions. This is useful when environments to compile for all targets might not be available on the user's machine, or if the user wants to only compile some targets selectively. Also once appveyor has support to build Win10 targets, we will not pass the "--with-vstudiotargetver" to the configure script. Signed-off-by: Shashank Ram <rams@vmware.com> Acked-by: Anand Kumar <kumaranand@vmware.com> Acked-by: Alin Gabriel Serdean <aserdean@ovn.org> Signed-off-by: Alin Gabriel Serdean <aserdean@ovn.org>
* Documentation: Update NEWS and faqPravin Shelar2018-02-121-0/+1
| | | | | | | Per the Linux 4.14 kernel support. Signed-off-by: Greg Rose <gvrose8192@gmail.com> Acked-by: Pravin B Shelar <pshelar@ovn.org>
* openflow: Update list of features.Ben Pfaff2018-02-131-24/+0
| | | | | | | | Bundles are implemented for both OF1.3 and OF1.4+, so no need to keep it in the list. Packet type aware pipeline is now implemented too. Signed-off-by: Ben Pfaff <blp@ovn.org> Acked-by: William Tu <u9012063@gmail.com>
* ofp-errors: Add remaining OF1.4 and OF1.5 errors.Ben Pfaff2018-02-131-20/+0
| | | | | | | | | | | Also implements the backports of relevant errors to OF1.3 as specified in ONF extension pack 1 for OF1.3. ONF-JIRA: EXT-237 ONF-JIRA: EXT-230 ONF-JIRA: EXT-264 Signed-off-by: Ben Pfaff <blp@ovn.org> Acked-by: William Tu <u9012063@gmail.com>
* Implement OF1.3 extension for OF1.4 role status feature.Ben Pfaff2018-02-131-8/+0
| | | | | | | | | | ONF extension pack 1 for OpenFlow 1.3 defines how to implement the OpenFlow 1.4 "role status" message in OpenFlow 1.3. This commit implements that feature. ONF-JIRA: EXT-191 Signed-off-by: Ben Pfaff <blp@ovn.org> Acked-by: William Tu <u9012063@gmail.com>
* ofp-util, ofp-parse: Break up into many separate modules.Ben Pfaff2018-02-131-1/+1
| | | | | | | | | | | | ofp-util had been far too large and monolithic for a long time. This commit breaks it up into units that make some logical sense. It also moves the pieces of ofp-parse that were specific to each unit into the relevant unit. Most of this commit is just moving code around. Signed-off-by: Ben Pfaff <blp@ovn.org> Reviewed-by: Yifeng Sun <pkusunyifeng@gmail.com>
* docs: Update supported DPDK versions.Ian Stokes2018-02-131-1/+1
| | | | | | | | Update the OVS to DPDK release table to use the latest stable DPDK 16.11.4 for OVS 2.7. Signed-off-by: Ian Stokes <ian.stokes@intel.com> Acked-by: Mark Kavanagh <mark.b.kavanagh@intel.com>
* poc: Introduce Proof of Concepts (Package building)Ansis Atteka2018-02-121-0/+56
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This patch sets up foundations for Proof of Concepts that simply materialize documentation into Ansible instructions executed in virtualized Vagrant environment. This Proof of Concept allows to easily build: 1. *.deb packages on Ubuntu 16.04; AND 2. *.rpm packages on CentOS 7.4. It also sets up DEB and RPM repository over HTTP that can be used to pull these openvswitch packages with apt-get or yum from another host. This particular Proof of Concept is intended to address following use-cases: 1. for new OVS users to see how debian and rpm packages are built; 2. for developers to easily check for packaging build regressions; 3. for developers to easily share their sandbox builds into QE setups (opposed to manually copying binaries); 4. for developers to add other Proof of Concepts that possibly may require full end-to-end integration with other thirdparty projects (e.g. DPI, libvirt, IPsec) and need Open vSwitch packages. Tested-by: Greg Rose <gvrose8192@gmail.com> Reviewed-by: Greg Rose <gvrose8192@gmail.com> Signed-off-by: Ansis Atteka <aatteka@ovn.org>
* doc: Added OVS Conntrack tutorialAshish Varma2018-02-014-1/+576
| | | | | | | | | OVS supports connection tracker related match fields and actions. Added a tutorial to demonstrate the basic use cases for some of these match fields and actions. Signed-off-by: Ashish Varma <ashishvarma.ovs@gmail.com> Signed-off-by: Ben Pfaff <blp@ovn.org>
* netdev-dpdk: Add support for vHost dequeue zero copy (experimental)Ciara Loftus2018-01-312-0/+75
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Zero copy is disabled by default. To enable it, set the 'dq-zero-copy' option to 'true' when configuring the Interface: ovs-vsctl set Interface dpdkvhostuserclient0 options:vhost-server-path=/tmp/dpdkvhostuserclient0 options:dq-zero-copy=true When packets from a vHost device with zero copy enabled are destined for a single 'dpdk' port, the number of tx descriptors on that 'dpdk' port must be set to a smaller value. 128 is recommended. This can be achieved like so: ovs-vsctl set Interface dpdkport options:n_txq_desc=128 Note: The sum of the tx descriptors of all 'dpdk' ports the VM will send to should not exceed 128. Due to this requirement, the feature is considered 'experimental'. Testing of the patch showed a ~8% improvement when switching 512B packets between vHost devices on different VMs on the same host when zero copy was enabled on the transmitting device. Signed-off-by: Ciara Loftus <ciara.loftus@intel.com> Acked-by: Ilya Maximets <i.maximets@samsung.com> Signed-off-by: Ian Stokes <ian.stokes@intel.com>