crc-olsr6ds_qos-howto

OLSR Implementation for XORP

=========================================================================================
COMMUNICATION RESEARCH CENTER, CANADA

Copyright (c) 2004 Ying Ge, Communication Research Center Canada.
Copyright (c) 2002, 2003 Maoyu Wang, Communication Research Center Canada.

By Ying Ge:
1. Change the OLSR packet format and message processing procedure based on the OLSR RFC.
2. Add support of multiple interfaces to OLSR, including MID message creating and processing procedure as specified in the OLSR RFC.
3. Add QoS Support to OLSR

By Maoyu Wang:
1.Ported OLSR from IPv4 to IPv6, 
2.Added HNA functionality into OLSR IPv6 version
3.Added the default gateway functionality into OLSR by extending the HNA 
  message usage. The default gateway functionality supported the mobility
  by cooperating with Mobile IPv6 for a mobile node as well as supported 
  Internet access for MANET nodes 
CRCOLSR6DS_QoS HOWTO                                                     Version 1.0
==========================================================================================

This document describes how to install and use CRCOLSR6DS_QOS, a routing demon.
CRCOLSR6DS_QOS implements QoS version of Optimized Link State Routing (OLSR) protocol for mobile ad hoc networks
in IPv6 network.

TABLE OF CONTENTS

1. DAEMON DESCRIPTION
2. REQUIREMENTS
3. INSTALLATION & USE

-------------------------------------------------------------------------------------------
1. DAEMON DESCRIPTION

CRCOLSR6DS_QOS maintains up to date kernel routing table entries in IPv6 MANET network. 
It uses UDP port 698 and supports IPv6 addresses. 

2. REQUIREMENTS

2.1 System requirements

This version of CRCOLSR6D runs on Linux kernel version 2.x.x.

2.2 Daemon requirements

All nodes running CRCOLSR6DS_QOS must be configured as router.
To turn on routing capability,open /etc/sysconfig/network, and add the following setting
NETWORKING_IPV6=yes
IPV6FORWARDING=yes
IPV6_ROUTER=yes

3. INSTALLATION & USE

After unpacking crcolsr6ds_qos.tar.gz in home directory, compile and install as described after:

 a) run `` make all '' in the new crcolsr6d directory.

 b) log as root.

 c) in crcolsr6d_qos directory, run "./crcolsr6d_qos" to start up the daemon

   1.   To run the QoS version of OLSR, use the option " -qos "
   	For example: ./crcolsr6ds_qos -qos
	By default, NO QoS is used
   
   2.   If more than one interface are configured on the node, use the option `` -i '' to specify 
   	the name of the interface or interfaces which will be used by CRCOLSR6D_QOS. 
	
  	 For example `` ./crcolsr6ds_qos -i eth0 '' if the name of the interface is eth0.
   				
	 ATTENTION: ONLY one interface can be used in QoS OLSR   

   3.	Use " -maddr " to define the site local multicast address to be used by CRCOLSR6D_QOS
   
  	 For example "./crcolsr6ds_qos -maddr ff05::15" by setting the site local multicast address is ff05::15
	 
   4.	Use " -will" to define the WILLINGNESS of the node. WILLINGNESS ranges from 0-7. (See the OLSR RFC)
   
   	For example "./crcolsr6ds_qos -will 7" by setting the WILLINGNESS of the node as 7.
	
	BY DEFAULT, the node's willingness is WILL_DEFAULT -- 3.
	
   5.	Use "-d" to define a certain debug level. The debugging messages are printed both on screen and in a file
   	called "olsr_debug".
	
	For example "./crcolsr6ds_qos -d 6" by setting the debug level as 6.
	
	For details of the debug level, please refer to file README_DEBUG.
	
   6.	Use "-hyst" to use OLSR with hysteresis
   
   	For example "./crcolsr6ds_qos -hyst".
   
   	BY DEFAULT, NO hysteresis is used
 
 d)	In order to use HNA functionality, generate a configure.txt file and put the host or netowrk association message
   in the file. A example file configure.txt.example is put in the same directory. Follow the example format to input
   host addresses and prefix, network address and prefix.
   
 e) If you want global mobility and Internet access in the manet, you need to patch mipv6-0.9-v2.4.7, crcolsrmip
 	as well as install radvd-0.6.2pl4-crc.