View source for ONE/Functional Tests Guide

= Overview =

This shows how to use VPP lite to run the LISP functional tests on an Ubuntu host using namespaces and <code>af_packet</code> interfaces. The LispFlowMapping Map-Server/Resolver in OpenDaylight Beryllium is used as overlay control plane. 

= Build VPP lite for the first time =

Download and install vagrant from [https://www.vagrantup.com/downloads.html here].

Install VirtualBox, or the vagrant plugin for VMware.

 git clone https://gerrit.fd.io/r/vpp
 cd vpp/build-root/vagrant
 vagrant up

Wait for the VM to be provisioned and once it completes, you can access the VM with:

 vagrant ssh

To build VPP lite, in the VM do:

 cd /vpp
 export PLATFORM=vpp_lite
 make build
 make build-vat

For more details on how to build VPP see the [[VPP/Pulling,_Building,_Running,_Hacking_and_Pushing_VPP_Code | pulling, building, running, hacking and pushing VPP code ]] section.

= Setup Vagrant VM  =

Install bridge-utils and ethtool if needed:

 sudo apt-get install bridge-utils ethtool 

Optional, install wireshark.

=== ODL Map-Server/Resolver ===
Steps to install and configure ODL, assuming the SR1 tar archive is downloaded:

Install and configure ODL

<pre style="white-space:-moz-pre-wrap; white-space:-pre-wrap; white-space:-o-pre-wrap; white-space:pre-wrap; word-wrap:break-word;">
wget https://nexus.opendaylight.org/content/repositories/opendaylight.release/org/opendaylight/integration/distribution-karaf/0.5.0-Boron/distribution-karaf-0.5.0-Boron.tar.gz
tar xzf distribution-karaf-0.5.0-Boron.tar.gz
</pre>

Edit custom properties and change elp policy to "replace"

<pre>
./distribution-karaf-0.5.0-Boron/etc/custom.properties
</pre>

Run ODL 

<pre>
./distribution-karaf-0.5.0-Boron/bin/karaf
</pre>

To install LispFlowMapping Map-Server/Resolver, in the karaf console type:
<pre>
feature:install odl-lispflowmapping-msmr
</pre>

= Run the ONE functional tests =

Clone the one repo in the vagrant VM:

 cd ~
 git clone https://gerrit.fd.io/r/one

If running the whole test suite, execute the <code>run.sh</code> script and specify configuration method like:

 sudo ./run.sh --config-method cli|vat

Alternatively, if running a single test, execute the desired script and choose one of 'cli' or 'vat' as configuration method:

 sudo CFG_METHOD=cli|vat ./tests/<test_case>.sh

Supported methods are <code>vat</code> and <code>cli</code> and default is <code>vat</code>.

For step-by-step test execution you can directly pass <code>WAIT</code> parameter to the test script as follows:

 sudo WAIT=1 ./tests/<test_case>.sh

= Run the ONE functional tests with VPP 16.09 =

Clone the one repo in the vagrant VM:

 cd ~
 git clone https://gerrit.fd.io/r/one

Go to tests folder
 
 cd one/tests/data_plane/vpp_lite_topo/

To run all tests do:

 sudo ./run.sh

To run one test do:
 
 sudo ./tests/test_*.sh

To run a test step-by-step, edit the test file in <code>./tests/test_*.sh</code> and add to the test function call, typically the last line in the script, "wait" as a parameter.

For example to run the demo showed at the ODL Summit 2016 use:

 sudo WAIT=1 ./tests/test_smr_rtr_disjoint.sh