]> git.puffer.fish Git - mirror/frr.git/commitdiff
README: Add example configure statement for building test quagga code
authorMartin Winter <mwinter@netdef.org>
Thu, 1 Dec 2016 03:50:29 +0000 (19:50 -0800)
committerDonald Sharp <sharpd@cumulusnetworks.com>
Wed, 28 Nov 2018 01:22:11 +0000 (20:22 -0500)
tests/topotests/README.md

index 0e34091cc7666cf2a8ff505d11623c8567909691..69548f5577154f706c181707c042da5ca009e3e1 100644 (file)
@@ -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