Read Me

	BommaTux version 2.91
	(C) 2000 Wim Godden
	Copyright notice at the end of this document


WAT IS BOMMATUX ?

BommaTux is een utility om het netwerkverbruik op een Linux-compatibel systeem te meten. Het creŽert statistieken, zowel
textueel als grafisch. Het toont ook hoeveel data er nog getransferred mag worden tot de niet-officiŽle 2Gbyte/week limiet.


HOE WERKT HET ?

BommaTux maakt gebruik van het programma ipac (ip accounting) voor het verzamelen van gegevens. Deze gegevens worden door
BommaTux verwerkt en geŽxporteerd naar een html-file en 3 gif-files.


INTERN/EXTERN ?

BommaTux rekent enkel extern verkeer mee. Dit is alle verkeer dat niet bij de subnets 195.130.128.xxx-195.130.159.xxx
212.123.0.xxx-212.123.31.xxx en 213.224.0.xxx-213.224.127.xxx hoort, met uitzondering van de proxy servers (213.224.83.2,
213.224.83.6, 213.224.83.10 en 213.224.83.14).


VOORDELEN VAN BOMMATUX T.O.V. ANDERE UTILS

BommaTux is specifiek geschreven voor Pandora. Het filtert intern verkeer en toont het werkelijke verbruik zoals dit door
Pandora wordt gemeten (zie ook volgende item). Tevens toont het hoeveel Mbyte u nog mag transferren vandaag, zodat u niet over
uw 2Gbyte/week limiet gaat.


MEET BOMMATUX ECHT PERFECT ALLE DATA ?

Ja en nee. BommaTux meet alle data die over de netwerkkaart komt, dat staat vast. Het probleem is echter dat, indien er op de
locale loop van Pandora een enorme vertraging zit, het kan zijn dat gegevens die door Pandora wel geteld worden, niet tot bij
de netwerkkaart geraken. Pandora is hier zeer vaag over. Bijgevolg geeft BommaTux dan ook geen garantie dat de cijfers
100% kloppen. Ga dus niet elke week tot 1999Mbyte/week, eerder maximum tot 1900Mbyte/week.


VEREISTEN

Om BommaTux te kunnen draaien, zijn volgende items vereist :
- Linux kernel 2.2.x of hoger
- ipchains
- kernel gecopileerd met CONFIG_IP_FIREWALL op Yes.
- perl 5
- gcc
- make
- awk
- mktemp


INSTALLATIE

Opgelet : Slackware-gebruikers dienen eerst MKTEMP te installeren. Dit bestand is te vinden op
ftp://mirrors.pandora.be/mirrors4/ftp.redhat.com/redhat/redhat-6.2/i386/RedHat/RPMS/mktemp-1.5-2.i386.rpm en te installeren
met het commando rpm -i --nodeps mktemp-1.5-2.i386.rpm


Zorg ervoor dat je ingelogd bent als root, anders kan BommaTux de nodige netwerkkaart-monitoring niet installeren !
Deze installatieprocedure is gebaseerd op een RedHat-distributie. 
Om BommaTux te installeren :
- Ga naar de subdirectory ksh (cd ksh)
- Tik 'configure' en druk op enter
- Tik 'make install' en druk op enter. OPGELET : Indien de installatieprocedure iets vermeld van het toevoegen aan
/etc/shells/ kan je dit best negeren !
- Ga terug naar de installatie-directory van BommaTux (cd ..)
- Editeer het bestand 'bommatux'
- Type 'inst-bommatux'. BommaTux zal zich installeren in /opt/bommatux
- Voeg volgende lijnen toe aan uw crontab (om uw crontab te editeren, volstaat het meestal crontab -e te typen) :
*/5 * * * * /opt/bommatux/fetchipac > /dev/null 2>&1
1 * * * * /opt/bommatux/bommatux > /dev/null 2>&1
- Voeg volgende lijn toe aan uw /etc/rc.d/rc.local (best vlak na initialisatie van het netwerk) :
/opt/bommatux/startup


OPVRAGEN GEGEVENS

De website zal automatisch elk uur (1 minuut na het uur) gecreŽerd worden in de directory dat u in het bestand 'bommatux' bepaalde.



VOOR MEER INFORMATIE

Voor meer informatie kan u terecht op http://users.pandora.be/wibo/bommatux/ of via e-mail op bommatux@godden.net



COPYRIGHT

  Copyright (C) 2000 Wim Godden
 
  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.
 
  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.
 
  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.





EOF