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