-------------------------------------------------------------
DIFFUSE for OpenWRT: Quick Startup (released 13th April 2012)
-------------------------------------------------------------

This document is part of DIFFUSE for OpenWRT:
http://caia.swin.edu.au/urp/diffuse/
http://caia.swin.edu.au/urp/diffuse/openwrt/

It provides instructions for enabling DIFFUSE using a classification model 
that can identify First Person Shooter traffic.

see also: 
http://http://caia.swin.edu.au/urp/diffuse/downloads/DIFFUSE-Build-Firmware-howto.txt


INTRODUCTION
------------

This guide provides instructions on how to copy a classification model 
and shell script onto a DIFFUSE-capable router and how to then enable DIFFUSE. 
It is a 'quick startup' document that should allow you to get DIFFUSE running 
with the least amount of configuration. Please visit the following websites
for a more thorough guide to DIFFUSE and IPFW syntax.

DIFFUSE - Usage Examples: http://caia.swin.edu.au/urp/diffuse/examples.html
Setting up Dummynet Queues: http://info.iet.unipi.it/~luigi/dummynet/

The classification model loaded will identify First Person Shooter online game
traffic. For other models, or to learn how to build your own model, see the main
DIFFUSE distribution packages: http://caia.swin.edu.au/urp/diffuse/downloads.html


COPYING THE MODEL AND SHELL SCRIPT
----------------------------------

Copy the 'fps_model' folder to /root on the router using scp. Inside the fps_model 
folder is a file called 'rt_vs_other_plen+pcnt.c45.diffuse' - this is the classification
model.

Copy the 'start_diffuse.sh' file to /root on the router. Make this file executable with 
the command
	root@OpenWRT:~# chmod +x start_diffuse.sh

	
STARTING DIFFUSE
----------------	

Execute the script:
	root@OpenWRT:~# ./start_diffuse.sh

This loads the classification model and configures the priority queues.
You may see an error that resembles:
	sysctlbyname fopen error reading filename ...ers/pipe_slot_limit
This can be ignored.

To see statistics on how many packets have been classified, use the command:
	root@OpenWRT:~# ipfw show

The output will resemble:
	00010 0 0 queue 1 ip4 from any to any match-if-class myclass:rt in
	00010 0 0 queue 2 ip4 from any to any match-if-class myclass:other in
	00010 0 0 queue 2 ip4 from any to any in
	65535 0 0 allow ip from any to any

DIFFUSE is now enabled and classification and prioritisation is active. 


CONTRIBUTIONS
-------------

We welcome your feedback and contributions! If you have discovered a bug,
have a request for a new feature, have produced a code patch or a new 
classifier model, please contact Nigel Williams (njwilliams@swin.edu.au).


CONTACT
-------

The DIFFUSE website is: http://www.caia.swin.edu.au/urp/diffuse

If you have any questions or want to report any bugs please contact
Nigel Williams (njwilliams@swin.edu.au).

Centre for Advanced Internet Architectures
Swinburne University of Technology
Melbourne, Australia
CRICOS number 00111D
http://www.caia.swin.edu.au