mirror/osrg-gobgp
1
0
Fork 0
mirror of https://github.com/osrg/gobgp.git synced 2024-05-11 05:55:10 +00:00
Code Issues Releases Activity

scenario_test: update README.md

Browse Source 
Signed-off-by: Hiroshi Yokoi <[email protected]>
This commit is contained in:
Hiroshi Yokoi
2015-11-05 16:02:03 +09:00
parent ac00ab2d2d
commit 8d3ffc6fa4
1 changed files with 87 additions and 103 deletions
Download Patch File Download Diff File Expand all files Collapse all files
test/scenario_test/README.md
+87 -103
View File
@@ -1,120 +1,104 @@
Route Server Scenario Test
Scenario Test
========================
Preparation
-----------
Please set up Ubuntu 14.04 Server Edition virtual machine,
and install golang environment inside the VM.
This page explains how to set up a scenario test environment and run the test.
Setup
-----
Execute the following commands inside the VM:
## Prerequisites
Assume you finished setting up [Golang](https://golang.org/doc/install) and [Docker](https://docs.docker.com/installation/ubuntulinux/) 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.
## <a name="section0"> Check
Please check if Golang and Docker is installed correctly and
make sure the $GOPATH is defined.
- ##### 1. Install and setting the packages required to run the scenario test.
```shell
$ 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
$ sudo apt-key adv --keyserver hkp://pgp.mit.edu:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D
$ sudo apt-get install docker-engine
$ gpasswd -a `whoami` docker
$ 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
```
## <a name="section1"> Set up dependencies
Execute the following commands inside the VM to install the dependencies:
1. Install pip and [pipework](https://github.com/jpetazzo/pipework).
```shell
$ 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
```
<br>
1. Get docker images.
Download docker images pertaining to GoBGP testing.
```shell
$ sudo docker pull golang:1.5
$ sudo docker pull osrg/quagga
$ sudo docker pull osrg/gobgp
```
<br>
1. Clone gobgp and install python libraries.
```shell
$ mkdir -p $GOPATH/src/github.com/osrg
$ cd $GOPATH/src/github.com/osrg
$ git clone https://github.com/osrg/gobgp.git
$ cd ./gobgp/test/scenario_test
$ sudo pip install -r pip-requires.txt
```
<br>
- ##### 2. Get each docker image from Docker Hub.
```shell
$ sudo docker pull osrg/golang:1.5
$ sudo docker pull osrg/quagga
$ sudo docker pull osrg/gobgp
## <a name="section2"> 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.
```
<br>
- ##### 3. Download gobgp and install python libraries.
```shell
$ git clone https://github.com/osrg/gobgp.git
$ cd ./gobgp
$ GOBGP_DIR=`pwd`
$ cd ${GOBGP_DIR}/test/scenario_test
$ pip install -r pip-requires.txt
```
<br>
Start
-----
##### All scenario test
You can run the all scenario test in the following shell script.
```shell
./run_all_tests.sh [<option>...]
```
<br>
##### If the individual to run the scenario test
- test of bgp_router_test only
```shell
sudo -E python bgp_router_test.py [<option>...] -s
$ cd $GOPATH/src/github.com/osrg/gobgp
$ sudo fab -f ./test/scenario_test/lib/base.py make_gobgp_ctn --set tag=gobgp
```
- test of bgp_zebra_test only
## <a name="section3"> Run 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.
```shell
sudo -E python bgp_zebra_test.py [<option>...] -s
$ cd $GOPATH/src/github.com/osrg/gobgp/test/scenario_test
$ ./run_all_tests.sh
...
OK
all tests passed successfully
```
- test of evpn_test only
```shell
sudo -E python evpn_test.py [<option>...] -s
```
- test of flow_spec_test only
```shell
sudo -E python flow_spec_test.py [<option>...] -s
## <a name="section4"> Clean up
A lot of containers are created during the test.
Let's clean up.
```
- test of global_policy_test only
```shell
sudo -E python global_policy_test.py [<option>...] -s
$ sudo docker rm -f $(sudo docker ps -a -q)
```
- test of ibgp_router_test only
```shell
sudo -E python ibgp_router_test.py [<option>...] -s
```
- test of route_reflector_test only
```shell
sudo -E python route_reflector_test.py [<option>...] -s
```
- test of route_server_ipv4_v6_test only
```shell
sudo -E python route_server_ipv4_v6_test.py [<option>...] -s
```
- test of route_server_test only
```shell
sudo -E python route_server_test.py [<option>...] -s
```
- test of route_server_policy_test only
```shell
sudo -E python route_server_policy_test.py [<option>...] -s
```
- test of route_server_policy_grpc_test only
```shell
sudo -E python route_server_policy_grpc_test.py [<option>...] -s
```
Options
-----
| short |long | description |
|--------|-------------------|--------------------------------|
| - | --test-prefix | filename format |
| - | --gobgp-image | output directory of dump files |
| - | --exabgp-path | filename format |
| - | --gobgp-log-level | output directory of dump files |
| - | --test-index | output directory of dump files |