Short Introduction on how to use the IBGF

hft.leipzig.de

Short Introduction on how to use the IBGF

ong>Shortong> ong>Introductionong> on how to use the IBGF

System Requirements

Kernel

Traffic Control is build into the kernel, so it may be disabled in some cases. There are different

types of queueing schedulers, for example:

#

# QoS and/or fair queueing

#

CONFIG_NET_SCHED=y

CONFIG_NET_SCH_CBQ=m

CONFIG_NET_SCH_HTB=m

CONFIG_NET_SCH_CSZ=m

CONFIG_NET_SCH_PRIO=m

CONFIG_NET_SCH_RED=m

CONFIG_NET_SCH_SFQ=m

CONFIG_NET_SCH_TEQL=m

CONFIG_NET_SCH_TBF=m

CONFIG_NET_SCH_GRED=m

CONFIG_NET_SCH_DSMARK=m

CONFIG_NET_SCH_INGRESS=m

CONFIG_NET_QOS=y

CONFIG_NET_ESTIMATOR=y

CONFIG_NET_CLS=y

CONFIG_NET_CLS_TCINDEX=m

CONFIG_NET_CLS_ROUTE4=m

CONFIG_NET_CLS_ROUTE=y

CONFIG_NET_CLS_FW=m

CONFIG_NET_CLS_U32=m

CONFIG_NET_CLS_RSVP=m

CONFIG_NET_CLS_RSVP6=m

CONFIG_NET_CLS_POLICE=y

CBQ (Class-Based Queueing), TBF (Token Bucket Filter) and SFQ (Stochastic Fairness Queueing) are

used for this project, but they may be easily replaced if the replacement is set up in the kernel.

Tools

Required tools are:

iptables

iproute2

perl 5 including module Frontier-RPC, DBI

mysql (current setting: url: localhost / user: root / pw: admin)

There could be a problem to find the right ethernet interface an its ip-adress, this is sourced in the

script if.sh in the programm/scripts folder. It is possible that the parsing from 'route' and 'ifconfig' is

broken due to language issues. To repair this it is neccessary to modify this script to your needs.

1 von 4


Overview of IBFG functions

This is the detailed structure of the current IBGF.

Current IBGF setup

Network setup

Currently the IBGF has a static setup to work in the following network.

It is encouraged to use this setup, at least for an initial test. Because some of the IP's are static and

not yet auto-detected.

Traffic Control setup

The current settings for traffic control can be viewed in the following picture. There are 6 classes,

one for Best Effort (sfq) and five classes for the QoS classes defined in the ITU-T recommendation

Y.1541.

2 von 4


MySQL setup

The IBGF doesn't set it's own database or table. Following this it is neccessary to create the

database and table manualy. The database is called ibgf and the name of the table is terminations.

The next picture shows the table which is used by the IBGF.

3 von 4


Start and monitor the IBGF

To start the IBGF just go into the IBGF root folder and execute the file init.sh.

cd /path_to_IBGF/

./init.sh

### you have to be root and in this folder to execute this script

This init script also executes a rudimentary spdf. This will give you the chance to open some ports

for traffic. There are some examples and a list of options in the spdf script (/path_to_IBGF

/spdf/spdf.sh).

If all is well the IBGF starts its work and gives some informational output, if not there will be an

error message. If the IBGF says nothing and stops with „ERROR!“ then you might try to simply

restart the IBGF, this issue occured during tests, especially while repeatedly starting and stopping

the IBGF.

To stop the IBGF and reset everything you can use the script kill-ibgf.sh located in the root folder.

You can use the script stats.sh to monitor the incomming and outgoing traffic. However this is only

a little example. Problably you want to modify this to your own convenience.

4 von 4

More magazines by this user
Similar magazines