summaryrefslogtreecommitdiffstats
path: root/tests/topotests/README.md
diff options
context:
space:
mode:
authorMartin Winter <mwinter@netdef.org>2016-12-01 04:50:29 +0100
committerDonald Sharp <sharpd@cumulusnetworks.com>2018-11-28 02:22:11 +0100
commit024fc0b8bc537e2c962ef2620bd3d5b7bf7dea55 (patch)
treedf4c7891385ffb77e7c96ee8f74358567494f095 /tests/topotests/README.md
parentbgp_multiview_topo1: Change from unified to context diff for better readability (diff)
downloadfrr-024fc0b8bc537e2c962ef2620bd3d5b7bf7dea55.tar.xz
frr-024fc0b8bc537e2c962ef2620bd3d5b7bf7dea55.zip
README: Add example configure statement for building test quagga code
Diffstat (limited to 'tests/topotests/README.md')
-rw-r--r--tests/topotests/README.md30
1 files changed, 28 insertions, 2 deletions
diff --git a/tests/topotests/README.md b/tests/topotests/README.md
index 0e34091cc..69548f557 100644
--- a/tests/topotests/README.md
+++ b/tests/topotests/README.md
@@ -1,7 +1,7 @@
# Quagga Topology Tests with Mininet
## Installation of Mininet for running tests
-Only tested with Ubuntu 16.04
+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)
@@ -36,11 +36,12 @@ Optional, will give better output
4. reboot (for options to take effect)
-### Quagga Installation
+## 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
@@ -49,6 +50,31 @@ like the standard Ubuntu Packages:
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