From b96029f6a200e0348bd9d858b81e92b86cd2e78b Mon Sep 17 00:00:00 2001 From: Jakub Libosvar Date: Wed, 12 Apr 2017 15:34:41 +0200 Subject: [PATCH] docs: Update TESTING.rst with gate information about ovs We used to compile from source for functional and fullstack jobs. For functional job we skip single test and avoid compiling. We still do compile from source for fullstack job. This patch adds justification to TESTING.rst document. Change-Id: I60c272bba6fa9eeefa29dfa4faa69433989efde2 --- TESTING.rst | 27 +++++++++++++++++++++++---- 1 file changed, 23 insertions(+), 4 deletions(-) diff --git a/TESTING.rst b/TESTING.rst index 363d25d00d1..04fd217539d 100644 --- a/TESTING.rst +++ b/TESTING.rst @@ -150,10 +150,7 @@ Functional tests (neutron/tests/functional/) are intended to validate actual system interaction. Mocks should be used sparingly, if at all. Care should be taken to ensure that existing system resources are not modified and that resources created in tests are -properly cleaned up both on test success and failure. Note that when run -at the gate, the functional tests compile OVS from source. Check out -neutron/tests/contrib/gate_hook.sh. Other jobs presently use OVS from -packages. +properly cleaned up both on test success and failure. Let's examine the benefits of the functional testing framework. Neutron offers a library called 'ip_lib' that wraps around the 'ip' binary. @@ -210,6 +207,15 @@ attributes and configures dnsmasq for that network, the test: namespace. * Assert that the device successfully obtained the expected IP address. +Gate exceptions ++++++++++++++++ + +Test neutron.tests.functional.agent.test_ovs_flows.OVSFlowTestCase.\ +test_install_flood_to_tun is currently skipped on upstream gate because Ubuntu +Xenial 16.04 contains openvswitch 2.5.0. This version contains bug where appctl +command prints wrong output for Final flow. It's been fixed in openvswitch +2.5.1 in `this commit `_. + Fullstack Tests ~~~~~~~~~~~~~~~ @@ -303,6 +309,19 @@ bridge connected to that port. The test is a true integration test, in the sense that it invokes the API and then asserts that Neutron interacted with the hypervisor appropriately. +Gate exceptions ++++++++++++++++ + +Currently we compile openvswitch kernel module from source for fullstack job on +the gate. The reason is to fix bug related to local VXLAN tunneling which is +present in current Ubuntu Xenial 16.04 kernel. Kernel was fixed with this +`commit `_ +and backported with this +`openvswitch commit `_. +Due to kernel compatibility, Ubuntu Trusty (Mitaka release) uses openvswitch +version 2.5.1. Ubuntu Xenial jobs use 2.6.1. Both versions contain fixes for +local VXLAN tunneling. + API Tests ~~~~~~~~~