== How-to install renetcol on a Debian Linux 32bits ==

 * ask renetcol-0.0.14.tar.gz file to andreu[at]renater[dot]fr

 * RENETCOL install:
  * gcc
{{{
apt-get install gcc
}}}
  * Embedded GNU C Library: Profiling Libraries (for centOS, the library name is glibc-utils.x86 and you need to change the Makefile.am file: `-lc_p => -lpcprofile`)
{{{
apt-get install libc6-prof
}}}
  * RRD library
{{{
apt-get install librrd2-dev
}}}
  * make
{{{
apt-get install make
}}}
  * psmisc
{{{
apt-get install psmisc
}}}
  * extract archive
{{{
tar xvzf renetcol-0.0.14.tar.gz
}}}
  * go to the directory
{{{
cd renetcol-0.0.14
}}}
  * edit renetcol parameters file
{{{
vi src/renetcolParam.h
}}}
  * declaration of your routeurs exporters
{{{
vi conf/routers.txt
}}}
  * if you use accounting 
{{{
vi conf/IPv4_Subnet_Aggregation_based_on_SNMP_index.txt
}}}
  * configure step
{{{
./configure --enable-multisampling=yes
}}}
  * make
{{{
make all
}}}
  * change the path in the launcher script
{{{
vim tool/check.sh
}}}
  * and run it
{{{
/bin/sh /home/andreu/renetcol-0.0.14/tool/check.sh /home/andreu/renetcol-0.0.14
}}}

 * Configuration of your network:
  * routers declaration (spaces, an empty line is required if you have only one routers):
{{{
debianFXvmw:/home/andreu/renetcol-0.0.14# cat conf/routers.txt
1 router1 192.168.0.1 null

debianFXvmw:/home/andreu/renetcol-0.0.14#
}}}
  * subnets declaration (tabulation and not spaces, last field must not be present if `--enable-multisampling=no`):
{{{
debianFXvmw:/home/andreu/renetcol-0.0.14# cat conf/IPv4_Subnet_Aggregation_based_on_SNMP_index_MS.txt
192.168.0.0    24      10
debianFXvmw:/home/andreu/renetcol-0.0.14#
}}}
  * interfaces SNMP index declaration (C for customer, B for backbone interface):
{{{
debianFXvmw:/home/andreu/renetcol-0.0.14# cat /home/andreu/renetcol-0.0.14/conf/SNMP_INDEX.txt
R 192.168.0.1
I 1 C
I 2 C
I 4 B
I 9 B
I 10 C
I 11 C
I 12 C
I 13 B
I 14 C
I 15 C
debianFXvmw:/home/andreu/renetcol-0.0.14#
}}}

 * First `ps` output:
{{{
root     14876     1  0 15:32 ?        00:00:00 /home/andreu/renetcol-0.0.14/src/renetcol
root     14878     1  0 15:32 ?        00:00:00 /home/andreu/renetcol-0.0.14/src/renetcolSender /home/andreu/renetcol-0.0.14/src/renetcol 1
root     14879 14878  0 15:32 ?        00:00:00 /home/andreu/renetcol-0.0.14/src/renetcolSender /home/andreu/renetcol-0.0.14/src/renetcol 1
root     14881     1  0 15:32 ?        00:00:00 /home/andreu/renetcol-0.0.14/src/renetcolAgg
}}}
 * `ps` output after a renetcolGUI client request:
{{{
root     14876     1  0 15:32 ?        00:00:02 /home/andreu/renetcol-0.0.14/src/renetcol
root     14878     1  0 15:32 ?        00:00:00 /home/andreu/renetcol-0.0.14/src/renetcolSender /home/andreu/renetcol-0.0.14/src/renetcol 1
root     14879 14878  0 15:32 ?        00:00:00 /home/andreu/renetcol-0.0.14/src/renetcolSender /home/andreu/renetcol-0.0.14/src/renetcol 1
root     14881     1  0 15:32 ?        00:00:00 /home/andreu/renetcol-0.0.14/src/renetcolAgg
root     14884 14879  0 15:36 ?        00:00:00 [renetcolSender] <defunct>
}}}

 * renetcolGUI install :
  * on Linux and Windows XP, see : http://renetcol.renater.fr/wiki/renetcolGUI
  * on WIndows 7, python2.6 is required (and not 2.7) and the 32 bits version (even if you have a 7 64bits):
{{{
http://www.python.org/ftp/python/2.6.6/python-2.6.6.msi
http://ftp.gnome.org/pub/gnome/binaries/win32/gtk+/2.16/gtk+-bundle_2.16.6-20100912_win32.zip
Unzip in C:\Program Files (x86)\GTK
 open a DOS shell and apply the command :
REG ADD "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v Path /d "%PATH%;C:\Program Files\GTK\bin" /f
 reboot ;)
http://ftp.acc.umu.se/pub/GNOME/binaries/win32/pygtk/2.16/pygtk-2.16.0.win32-py2.6.exe
http://www.salsabeatmachine.org/python/pycairo-1.8.10.win32-py2.6.exe
http://ftp.gnome.org/pub/GNOME/binaries/win32/pygobject/2.26/pygobject-2.26.0-1.win32-py2.6.exe
 check your firewall, the collector must send UDP packet on port 2222 to your station where renetcolGUI is installed
}}}