[Routingtools-cvs] tools/doc/howto HTB-HOWTO,NONE,1.1

[<hur...@us...>]

Update of /cvsroot/routingtools/tools/doc/howto
In directory sc8-pr-cvs1:/tmp/cvs-serv30412/doc/howto

Added Files:
	HTB-HOWTO 
Log Message:
- added HTB howto


--- NEW FILE: HTB-HOWTO ---
How To Get HTB Running
----------------------

This document describes the steps needed to get HTB running. HTB is a
module loaded by the traffic shaping script to shape the traffic passing
the router. Two things are needed to make HTB working:

* kernel support (HTB patch applied or at least kernel 2.4.20)
* a TC binary capable of handling the HTB module

An i386 binary of TC for Linux which is capable of handling HTB is
downloadable from our files section. It is meant to be installed to
/usr/local/sbin coexisting with a distribution-provided TC located in
/usr/sbin. Our scripts are prepared to use the TC provided here only for
HTB while using the distribution-provided and thus compatible TC for most
other tasks. If you think you do not need the TC provided here change our
scripts to only use the HTB provided with your distribution.

Additionally you need kernel support for HTB. In most cases HTB is
provided as a module in most distributions using a kernel version of
2.4.20 or higher. In this case everything should be fine. If your
distribution does not support HTB it is recommended to build your own
kernel.

If you need to use a kernel prior to 2.4.20 you have to patch your kernel
to support HTB. These patches can be found at
http://luxik.cdi.cz/~devik/qos/htb/. However, we recommend to use a
current kernel instead of patching an old one unless there is a specific
reason to not use a current one (e.g. incompatibilities with your
distribution and/or hardware). Patching requires to recompile your kernel
in order to create the modules required for HTB support.