root/trunk/README @ 29

Revision 8, 3.1 KB (checked in by andreu, 17 years ago)

second RENETCOL CVS Integration

  • Property svn:eol-style set to native
Line 
1 ----------------------
2|       Install        |
3 ----------------------
4
5        tar xvzf renetcol-0.0.2.tar.gz
6        cd renetcol-0.0.2
7        ./configure
8        (before the make command you MUST change some values in renetcol.h, see below)
9        make
10        make install (if you want)
11
12 --------------------------------------
13| Collector requirements before compil |
14 --------------------------------------
15
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)
21
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
60    on Linux:
61       cd tool
62       python renetcolGUI_0_0_2.py
63    on Win32:
64       copy the file renetcolGUI_0_0_2.py on your system
65       install python, GTK and requirements:
66               for python:
67                   http://www.python.org/ download section
68                   the last release is the 2.4.1 (python-2.4.1.msi)
69               for pyGTK:
70                   http://www.pcpm.ucl.ac.be/~gustin/win32_ports/
71                   section pygtk on win32
72                   last release is pygtk 2.6 (pygtk-2.6.2-2.win32-py2.4.exe)
73               for GTK+:
74                   http://gladewin32.sourceforge.net/
75                   last release 2.6.8 (Runtime Environment Installer 2.6.8-rc1)
76
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
81
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).
91       
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.
Note: See TracBrowser for help on using the browser.