blob: 69548f5577154f706c181707c042da5ca009e3e1 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
|
# Quagga Topology Tests with Mininet
## Installation of Mininet for running tests
Only tested with Ubuntu 16.04 (which uses Mininet 2.2.0)
Instructions are the same for all setups (ie ExaBGP is only used for BGP
tests)
### Installing Mininet Infrastructure:
1. apt-get install mininet
2. apt-get install python-pip
3. apt-get install iproute
4. pip install ipaddr
5. pip install pytest
6. pip install exabgp
7. useradd -d /var/run/exabgp/ -s /bin/false exabgp
### Enable Coredumps
Optional, will give better output
1. apt-get install gdb
2. disable apport (which move core files)
Set `enabled=0` in `/etc/default/apport`
3. Update security limits
Add/change `/etc/security/limits.conf` to
#<domain> <type> <item> <value>
* soft core unlimited
root soft core unlimited
* hard core unlimited
root hard core unlimited
4. reboot (for options to take effect)
## Quagga Installation
Quagga needs to be installed separatly. It is assume to be configured
like the standard Ubuntu Packages:
- Binaries in /usr/lib/quagga
- State Directory /var/run/quagga
- Running under user quagga, group quagga
- vtygroup: quaggavty
- config directory: /etc/quagga
- For Quagga Packages, install the dbg package as well for coredump decoding
No Quagga config needs to be done and no Quagga daemons should be run ahead
of the test. They are all started as part of the test
#### Manual Quagga build
If you prefer to manually build Quagga, then use the following suggested config:
./configure \
--prefix=/usr \
--localstatedir=/var/run/quagga \
--sbindir=/usr/lib/quagga \
--sysconfdir=/etc/quagga \
--enable-vtysh \
--enable-pimd \
--enable-multipath=64 \
--enable-user=quagga \
--enable-group=quagga \
--enable-vty-group=quaggavty \
--with-pkg-extra-version=-my-manual-build
And create Quagga User and Quaggavty group as follows:
addgroup --system --gid 92 quagga
addgroup --system --gid 85 quaggavty
usermod -G quaggavty quagga
adduser --system --ingroup quagga --home /var/run/quagga/ \
--gecos "Quagga routing suite" --shell /bin/false quagga
## Executing Tests
#### Execute all tests with output to console
py.test -s -v --tb=no
All test_* scripts in subdirectories are detected and executed (unless disabled in
`pytest.ini` file)
`--tb=no` disables the python traceback which might be irrelevant unless the
test script itself is debugged
#### Execute single test
cd test_to_be_run
./test_to_be_run.py
For further options, refer to pytest documentation
Test will set exit code which can be used with `git bisect`
For the simulated topology, see the description in the python file
If you need to clear the mininet setup between tests (if it isn't cleanly
shutdown), then use the `mn -c` command to clean up the environment
## License
All the configs and scripts are licensed under a ISC-style license. See
Python scripts for details.
|
