Version 13 (modified by andreu, 11 years ago)

--

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