Changeset 8 for trunk/README

Show
Ignore:
Timestamp:
10/20/05 15:05:40 (17 years ago)
Author:
andreu
Message:

second RENETCOL CVS Integration

Files:
1 modified

Legend:

Unmodified
Added
Removed
  • trunk/README

    r7 r8  
    1 Install the collector: 
    2         tar xvzf renetcol_0_0_1.tar.gz 
    3         cd renetcol_0_0_1 
     1 ---------------------- 
     2|       Install        | 
     3 ---------------------- 
     4 
     5        tar xvzf renetcol-0.0.2.tar.gz 
     6        cd renetcol-0.0.2 
    47        ./configure 
     8        (before the make command you MUST change some values in renetcol.h, see below) 
    59        make 
    610        make install (if you want) 
    711 
    8 Collector requirements: 
    9         create your IPv4 prefix file (or keep the default for test: IPv4_prefix.txt) 
    10         create your router list file 
    11         change the line 29 and 30 of renetcol.h file (your collector address:port) 
     12 -------------------------------------- 
     13| Collector requirements before compil | 
     14 -------------------------------------- 
    1215 
    13 Commands: 
    14         ./renetcol ... : launch the collector (if no message, it's good) 
    15                         during execution you can see the /var/log/message file 
    16         ./renetcolSender ... : to use the remote client 
    17         ./renetcolMsgCtl ... : to kill the message queue  
     16Change the following values in renetcol.h *REQUIRED*: 
     17#define RECEPTION_ADDRESS "10.0.0.1"  
     18#define RECEPTION_PORT 9999 
     19(this two values are the values configured on your routers to export Netflow 
     20datagrams) 
    1821 
    19 Use the client tool (python+GTK): 
     22 -------------------------------------- 
     23| Collector requirements before start  | 
     24 -------------------------------------- 
     25 
     26        - create your IPv4 prefix file (or keep the default for test:  
     27IPv4_prefix.txt, in this release the file must be present with a good syntax, 
     28but data are not important) 
     29        - create your router list file *REQUIRED* (exemple in src/routers.txt): 
     30syntax: <id> <name> <first IPv4 address> <second IPv4 or NULL> 
     31keep this first line: 0 null 0.0.0.0 null 
     32 
     33Note: no comment line in this two files. 
     34 
     35 
     36 ---------- 
     37| Commands | 
     38 ---------- 
     39 
     40        ./renetcol ... : launch the collector (you must be root) 
     41        ./renetcolSender ... : to use remote client 
     42        ./renetcolMsgCtl ... : to kill the message queue if you kill renetcol   
     43 
     44 ------------------- 
     45| Commands exemples | 
     46 ------------------- 
     47 
     48colnet:/tmp/renetcol_user/src# ./renetcol routers.txt IPv4_prefix.txt rules.txt 
     49 
     50colnet:/tmp/renetcol_user/src# ./renetcolSender renetcol 1 rules.txt 
     51 
     52colnet:/tmp/renetcol_user/src# killall renetcol 
     53colnet:/tmp/renetcol_user/src# killall renetcolSender 
     54colnet:/tmp/renetcol_user/src# ./renetcolMsgCtl renetcol 
     55 
     56 ---------------------------------- 
     57| Use the client tool (python+GTK) | 
     58 ---------------------------------- 
     59 
    2060    on Linux: 
    2161       cd tool 
    22        python renetcolGUI_0_0_1.py 
     62       python renetcolGUI_0_0_2.py 
    2363    on Win32: 
    24        copy the file on your box 
     64       copy the file renetcolGUI_0_0_2.py on your system 
    2565       install python, GTK and requirements: 
    2666               for python: 
     
    3575                   last release 2.6.8 (Runtime Environment Installer 2.6.8-rc1) 
    3676 
     77    Collector (renetcolSender) and remote client communication *REQUIRED*: 
     78        you MUST change few values in the renetcolGUI_0_0_2.py file: 
     79                - line 28 : path to GTK 
     80                - line 47 to 53 : IP protocol choice and collector address 
    3781 
     82    *REQUIRED* In this release (0.0.2) the client tool host MUST be have a 
     83 reverse DNS for his name. If not the collector will not be able to  
     84communicate with the client. Explication: the rules are registered on the  
     85collector in the conf file (rules.txt) in such way: 
     86        N 53.renater.fr 
     87        O socket 53.renater.fr 2222 
     88        C 60 = 6 
     89It's not a requirement for rules applied directly in this file (with an  
     90editor). 
    3891         
     92    Note: For your first action from the client to the collector it's  
     93possible to have a delay (>20s, it depends on the delay between two template 
     94definition). This delay desappears after.