kube-router/vendor/github.com/osrg/gobgp/test/scenario_test

Scenario Test

This page explains how to set up a scenario test environment and run the test.

Prerequisites

Assume you finished setting up Golang and Docker on Ubuntu 14.04 Server VM. We recommend allocating memory more than 8GB to the VM. Because this scenario test runs a lot of test cases concurrently.

Check

Please check if Golang and Docker is installed correctly and make sure the $GOPATH is defined.

$ go version
go version go1.5.1 linux/amd64

$ echo $GOPATH
/home/yokoi-h/work

$ sudo docker version
Client:
 Version:      1.9.0
 API version:  1.21
 Go version:   go1.4.2
 Git commit:   76d6bc9
 Built:        Tue Nov  3 17:43:42 UTC 2015
 OS/Arch:      linux/amd64

Server:
 Version:      1.9.0
 API version:  1.21
 Go version:   go1.4.2
 Git commit:   76d6bc9
 Built:        Tue Nov  3 17:43:42 UTC 2015
 OS/Arch:      linux/amd64

Set up dependencies

Execute the following commands inside the VM to install the dependencies:

1. Install pip and pipework.

$ sudo apt-get update
$ sudo apt-get install git python-pip python-dev iputils-arping bridge-utils lv
$ sudo wget https://raw.github.com/jpetazzo/pipework/master/pipework -O /usr/local/bin/pipework
$ sudo chmod 755 /usr/local/bin/pipework

2. Get docker images. Download docker images pertaining to GoBGP testing.

$ sudo docker pull golang:1.7
$ sudo docker pull osrg/gobgp
$ sudo docker pull osrg/quagga
$ sudo docker pull osrg/quagga:v1.0
$ sudo docker pull osrg/exabgp

3. Clone GoBGP and install python libraries.

$ mkdir -p $GOPATH/src/github.com/osrg
$ cd $GOPATH/src/github.com/osrg
$ git clone https://github.com/osrg/gobgp.git
$ cd ./gobgp/test
$ sudo pip install -r pip-requires.txt

Install local source code

You need to install local source code into GoBGP docker container. You also need this operation at every modification to the source code.

$ cd $GOPATH/src/github.com/osrg/gobgp
$ sudo fab -f ./test/lib/base.py make_gobgp_ctn --set tag=gobgp

Run test

1. Run all test. You can run all scenario tests with run_all_tests.sh. If all tests passed, you can see "all tests passed successfully" at the end of the test.

$ cd $GOPATH/src/github.com/osrg/gobgp/test/scenario_test
$ ./run_all_tests.sh
...
OK
all tests passed successfully

2. Run each test. You can run scenario tests individually with each test file. See test/scenario_test/*.py, for the individual test files.

$ cd $GOPATH/src/github.com/osrg/gobgp/test/scenario_test
$ sudo -E PYTHONPATH=$GOBGP/test python <scenario test name>.py
...
OK

Clean up

A lot of containers, networks temporary files are created during the test. Let's clean up.

$ sudo docker rm -f $(sudo docker ps -a -q)
$ sudo docker network prune -f
$ sudo rm -rf /tmp/gobgp