On Thu, Nov 5, 2020 at 10:41 AM Ben Pfaff <b...@ovn.org> wrote: > > I hadn't run this before so I had to discover how it worked. > > Signed-off-by: Ben Pfaff <b...@ovn.org> > --- > Documentation/topics/testing.rst | 35 ++++++++++++++++++++++++++++++++ > tests/automake.mk | 6 ++++-- > 2 files changed, 39 insertions(+), 2 deletions(-) > > diff --git a/Documentation/topics/testing.rst > b/Documentation/topics/testing.rst > index 242608a17340..95e57dd6b98e 100644 > --- a/Documentation/topics/testing.rst > +++ b/Documentation/topics/testing.rst > @@ -188,3 +188,38 @@ Instructions to setup travis-ci for your GitHub > repository: > > 4. Pushing a commit to the repository which breaks the build or the > testsuite will now trigger a email sent to myl...@mydomain.org > + > +Datapath testing > +~~~~~~~~~~~~~~~~ > + > +OVN includes a suite of tests specifically for datapath functionality. > +The datapath tests make some assumptions about the environment. They > +must be run under root privileges on a Linux system with support for > +network namespaces. Make sure no other Open vSwitch instance is > +running the test suite. These tests may take several minutes to > +complete, and cannot be run in parallel. > + > +To invoke the datapath testsuite, run:: > + > + $ make check-system-userspace
OVN also supports running system tests using kernel datapath - make check-kernel. We can probably document that too ? Thanks Numan > + > +The tests themselves must run as root. If you do not run ``make`` as > +root, then you can specify a program to get superuser privileges as > +``SUDO=<program>``, e.g. the following uses ``sudo`` (the ``-E`` > +option is needed to pass through environment variables):: > + > + $ make check-system-userspace SUDO='sudo -E' > + > +The results of the testsuite are in ``tests/system-userspace-testsuite.dir``. > + > +The testsuite creates and destroys tap devices named ``ovs-netdev`` > +and ``br0``. If it is interrupted during a test, then before it can > +be restarted, you may need to destroy these devices with commands like > +the following:: > + > + ip tuntap del dev ovs-netdev mode tap > + ip tuntap del dev br0 mode tap > + > +All the features documented under `Unit Tests`_ are available for the > +userspace datapath testsuite, except that the datapath testsuite does > +not support running tests in parallel. > diff --git a/tests/automake.mk b/tests/automake.mk > index b363928fd73d..e7ea01f95065 100644 > --- a/tests/automake.mk > +++ b/tests/automake.mk > @@ -157,9 +157,11 @@ check-kernel: all > set $(SHELL) '$(SYSTEM_KMOD_TESTSUITE)' -C tests > AUTOTEST_PATH='$(AUTOTEST_PATH)'; \ > "$$@" $(TESTSUITEFLAGS) -j1 || (test X'$(RECHECK)' = Xyes && "$$@" > --recheck) > > - check-system-userspace: all > + > +SUDO = sudo -E > +check-system-userspace: all > set $(SHELL) '$(SYSTEM_USERSPACE_TESTSUITE)' -C tests > AUTOTEST_PATH='$(AUTOTEST_PATH)'; \ > - "$$@" $(TESTSUITEFLAGS) -j1 || (test X'$(RECHECK)' = Xyes && "$$@" > --recheck) > + $(SUDO) "$$@" $(TESTSUITEFLAGS) -j1 || (test X'$(RECHECK)' = Xyes && > $(SUDO) "$$@" --recheck) > > clean-local: > test ! -f '$(TESTSUITE)' || $(SHELL) '$(TESTSUITE)' -C tests --clean > -- > 2.26.2 > > _______________________________________________ > dev mailing list > d...@openvswitch.org > https://mail.openvswitch.org/mailman/listinfo/ovs-dev > _______________________________________________ dev mailing list d...@openvswitch.org https://mail.openvswitch.org/mailman/listinfo/ovs-dev
