root/trunk/README @ 34

 ----------------------
|       Install        |
 ----------------------

        tar xvzf renetcol-0.0.9.tar.gz
        cd renetcol-0.0.9
        ./configure
        (./configure --help)
        (before the make command you MUST change some values in renetcol.h, see below)
        make
        make install (if you want)

 --------------------------------------
| Collector requirements before compil |
 --------------------------------------

Change the following values in renetcol.h *REQUIRED*:
#define RECEPTION_ADDRESS "10.0.0.1" 
#define RECEPTION_PORT 9999
(this two values are the values configured on your routers to export Netflow
datagrams)

 --------------------------------------
| Collector requirements before start  |
 --------------------------------------

        - create your IPv4 prefix file (or keep the default for test: 
IPv4_prefix.txt, in "quick start" with "--enable-ipv4agg=no" you don't 
need a such file
        - create your router list file *REQUIRED* (exemple in src/routers.txt):
syntax: <id> <name> <first IPv4 address> <second IPv4 or NULL>
keep this first line: 0 null 0.0.0.0 null

Note: no comment lines in this two files.


 ----------
| Commands |
 ----------

        ./renetcol ... : launch the collector (you must be root)
        ./renetcolSender ... : to use remote client
        ./renetcolMsgCtl ... : to kill the message queue if you kill renetcol  

 -------------------
| Commands exemples |
 -------------------

colnet:/tmp/renetcol_user/src# ./renetcol routers.txt IPv4_prefix.txt rules.txt

colnet:/tmp/renetcol_user/src# ./renetcolSender renetcol 1 rules.txt

colnet:/tmp/renetcol_user/src# killall renetcol
colnet:/tmp/renetcol_user/src# killall renetcolSender
colnet:/tmp/renetcol_user/src# ./renetcolMsgCtl renetcol

We recommand to use in a crontab the script check.sh who is in tool/ directory.

 ----------------------------------
| Use the client tool (python+GTK) |
 ----------------------------------

    on Linux:
       cd tool
       python renetcolGUI_0_0_7.py
    on Win32:
       copy the file renetcolGUI_0_0_7.py on your system
       install python, GTK and requirements:
               for python:
                   http://www.python.org/ download section
               for pyGTK:
                   http://www.pcpm.ucl.ac.be/~gustin/win32_ports/
                   section pygtk on win32
               for GTK+:
                   http://gladewin32.sourceforge.net/

    Collector (renetcolSender) and remote client communication *REQUIRED*:
        you MUST change few values in the renetcolGUI_0_0_7.py file:
                - line 28 : path to GTK
                - line 47 to 53 : IP protocol choice and collector address

    *REQUIRED* In this release (0.0.9) the client tool host MUST be have a
 reverse DNS for his name. If not the collector will not be able to 
communicate with the client. Explication: the rules are registered on the 
collector in the conf file (rules.txt) in such way:
        N 53.renater.fr
        O socket 53.renater.fr 2222
        C 60 = 6
It's not a requirement for rules applied directly in this file (with an 
editor).
        
    Note: For your first action from the client to the collector it's 
possible to have a delay (>20s, it depends on the delay between two template
definition).