Difference between revisions of "ONE/Functional Tests Guide"

From fd.io
< ONE
Jump to: navigation, search
 
(28 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
= Overview =
 
= 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.  
 
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 =
 
= 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
 
  git clone https://gerrit.fd.io/r/vpp
Line 12: Line 17:
 
  vagrant ssh
 
  vagrant ssh
  
To build VPP lite, in the VM do:
+
To build VPP, in the VM do:
 +
 
 +
cd /vpp
 +
export PLATFORM=vpp
 +
make build
 +
 
 +
Note: For 17.01 and older versions you need to build VPP lite:
  
 
  cd /vpp
 
  cd /vpp
 
  export PLATFORM=vpp_lite
 
  export PLATFORM=vpp_lite
 
  make build
 
  make build
 +
make build-vat
  
For more details on how to build VPP see [[VPP/Pulling,_Building,_Running,_Hacking_and_Pushing_VPP_Code | pulling, building, running, hacking and pushing VPP code ]] section.
+
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  =
 
= Setup Vagrant VM  =
Line 29: Line 41:
  
 
=== ODL Map-Server/Resolver ===
 
=== ODL Map-Server/Resolver ===
Steps to install and configure ODL, assuming the SR1 tar archive is downloaded:
+
Steps to install and configure ODL, assuming the Boron tar archive is downloaded:
 +
 
 +
Install and configure ODL
  
Install and run 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;">
 
<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.4.1-Beryllium-SR1/distribution-karaf-0.4.1-Beryllium-SR1.tar.gz
+
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.4.1-Beryllium-SR1.tar.gz
+
tar xzf distribution-karaf-0.5.0-Boron.tar.gz
cd distribution-karaf-0.4.1-Beryllium-SR1/bin
+
</pre>
./karaf
+
 
 +
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>
 
</pre>
  
Line 43: Line 66:
 
feature:install odl-lispflowmapping-msmr
 
feature:install odl-lispflowmapping-msmr
 
</pre>
 
</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

Latest revision as of 14:30, 13 March 2017

Overview

This shows how to use VPP lite to run the LISP functional tests on an Ubuntu host using namespaces and af_packet 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 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, in the VM do:

cd /vpp
export PLATFORM=vpp
make build

Note: For 17.01 and older versions you need to build VPP lite:

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

For more details on how to build VPP see the 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 Boron tar archive is downloaded:

Install and configure ODL

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

Edit custom properties and change elp policy to "replace"

./distribution-karaf-0.5.0-Boron/etc/custom.properties

Run ODL

./distribution-karaf-0.5.0-Boron/bin/karaf

To install LispFlowMapping Map-Server/Resolver, in the karaf console type:

feature:install odl-lispflowmapping-msmr

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 run.sh 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 vat and cli and default is vat.

For step-by-step test execution you can directly pass WAIT 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 ./tests/test_*.sh 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