ENABLE DYNAMIC ROUTING

=======================================================================
  >>> This document contains the instructions of how to enable
  >>> dynamic Routing support for XBone running on either Linux 
  >>> or FreeBSD

-----------------------------------------------------------------------
Requirement
-----------------------------------------------------------------------

XBone uses an existing Routing Software "Quagga" to support Dynamic 
Routing. "Quagga" can be installed through ports on FreeBSD; For 
Linux, download the source tar ball from http://www.quagga.net,
unpack and install it (version 0.98.3 or above)

Quagga must be compiled with user and group such that the daemons have
permissions to (1) write log files in /var/run (2) the daemons are
able to add multicast addresses on interfaces. Platform-specific
instructions are given below: 

        > FreeBSD 
	 
	 % cd /usr/ports/net/quagga
	 % make ENABLE_USER=root ENABLE_GROUP=wheel install

         *** Quagga seems to munge root username and directory 
	     in /etc/passwd. Make sure they are in order to 
	     avoid surprises. use 'vipw"

       > Linux

         Install from the tar.gz that can be obtained from Quagga
	 main site http://www.quagga.net

	 % tar zxvf quagga-0.xxx.xx.tar.gz 
	 % cd quagga-0.xxx.xx
	 % ./configure --enable-user=root --enable-group=root --sysconfdir=/etc/quagga
         %  make install 

You should specify the zebra home directory in which zebra conf files, 
such as zebra.conf, ripd.conf and ripngd.conf locate, in every rd's 
configure file. For example, if the machine add.isi.edu is one RD in 
the overlay deployed by XBone, you should set the following entry 
correctly in add.conf:

  zebra_dir = /usr/local/etc/

Then on every RD,  
1.   run chmod -R 777 /var/run        
2    run: cp xbone/conf/zebra.conf.sample  $zebra_dir/zebra.conf
          cp xbone/conf/ripd.conf.sample  $zebra_dir/ripd.conf
	  cp xbone/conf/ripngd.conf.sample $zebra_dir/ripngd.conf
   change the line "hostname tlc.isi.edu" to "hostname your machine's
   hostname" for zebra.conf, ripd.conf and ripngd.conf respectively.

------------------------------------------------------------------------
Note
------------------------------------------------------------------------

It may take some time for routing information on RDs to converge.