| 1 | ----------------------------- |
|---|
| 2 | | Install resume | |
|---|
| 3 | ----------------------------- |
|---|
| 4 | |
|---|
| 5 | $ tar xvzf renetcol-0.0.14.tar.gz |
|---|
| 6 | $ cd renetcol-0.0.14 |
|---|
| 7 | {./configure | ./configure --enable-ipv4agg=no } |
|---|
| 8 | Steps 1&2 , see below |
|---|
| 9 | $ make |
|---|
| 10 | $ make install (optional) |
|---|
| 11 | |
|---|
| 12 | ---------------------- |
|---|
| 13 | | Step 1: before compil | |
|---|
| 14 | ---------------------- |
|---|
| 15 | |
|---|
| 16 | OS requirements : Linux distribution (tested on Debian Etch and Ubuntu7.1) |
|---|
| 17 | |
|---|
| 18 | You must changed some values in renetcolParam.h, values are detailed in the file. |
|---|
| 19 | |
|---|
| 20 | IPC System V MUST be installed on your OS. |
|---|
| 21 | |
|---|
| 22 | Specials packages requirements: |
|---|
| 23 | - libc6-dev |
|---|
| 24 | - libc6-prof |
|---|
| 25 | - librrd{0|2}-dev (if aggregation enabled) |
|---|
| 26 | |
|---|
| 27 | ------------------------------------- |
|---|
| 28 | | Step 2: before start | |
|---|
| 29 | ------------------------------------- |
|---|
| 30 | |
|---|
| 31 | - create your IPv4 prefix/subnet file (or keep the default for test: |
|---|
| 32 | conf/IPv4_prefix.txt). If you don't need aggregation you can keed the default |
|---|
| 33 | and select "--enable-ipv4agg=no" in configure procedure |
|---|
| 34 | |
|---|
| 35 | - create your router list file *REQUIRED* |
|---|
| 36 | (exemple in conf/routers.txt): |
|---|
| 37 | syntax: <id> <name> <first IPv4 address> <second IPv4 or NULL> |
|---|
| 38 | |
|---|
| 39 | Note: no comment lines in this two files. |
|---|
| 40 | |
|---|
| 41 | |
|---|
| 42 | ---------- |
|---|
| 43 | | Commands | |
|---|
| 44 | ---------- |
|---|
| 45 | |
|---|
| 46 | ./renetcol ... : launch the collector (you must be root) |
|---|
| 47 | ./renetcolSender ... : to use remote client |
|---|
| 48 | ./renetcolMsgCtl ... : to kill the IPC message queue if you kill renetcol |
|---|
| 49 | |
|---|
| 50 | We recommand to use the script *check.sh* (in tool/) to launch renetcol. |
|---|
| 51 | This script required in parameters the path to renetcol. |
|---|
| 52 | We can also put the script in your root crontab to verify the collector state, |
|---|
| 53 | for exemple: |
|---|
| 54 | 5,10,15,20,25,30,35,40,45,50,55 * * * * /bin/sh <path>/renetcol-0.0.14/tool/check.sh <path>/renetcol-0.0.14/ |
|---|
| 55 | |
|---|
| 56 | -------------------------- |
|---|
| 57 | | Others Commands exemples | |
|---|
| 58 | -------------------------- |
|---|
| 59 | |
|---|
| 60 | colnet:/tmp/renetcol_user/src# killall renetcol |
|---|
| 61 | colnet:/tmp/renetcol_user/src# killall renetcolSender |
|---|
| 62 | colnet:/tmp/renetcol_user/src# ./renetcolMsgCtl renetcol |
|---|
| 63 | |
|---|
| 64 | ---------------------------------- |
|---|
| 65 | | Use the client tool (python+GTK) | |
|---|
| 66 | ---------------------------------- |
|---|
| 67 | |
|---|
| 68 | on Linux: |
|---|
| 69 | cd tool |
|---|
| 70 | python renetcolGUI.py |
|---|
| 71 | on Win32: |
|---|
| 72 | copy the file renetcolGUI.py on your system |
|---|
| 73 | install python, GTK and requirements: |
|---|
| 74 | for python: |
|---|
| 75 | http://www.python.org/ download section |
|---|
| 76 | for pyGTK: |
|---|
| 77 | http://www.pcpm.ucl.ac.be/~gustin/win32_ports/ |
|---|
| 78 | section pygtk on win32 |
|---|
| 79 | for GTK+: |
|---|
| 80 | http://gladewin32.sourceforge.net/ |
|---|
| 81 | |
|---|
| 82 | *REQUIRED* Collector (renetcolSender) and remote client communication: |
|---|
| 83 | you MUST change few values in the renetcolGUI.py file: |
|---|
| 84 | - line 28 : path to GTK |
|---|
| 85 | - line 47 to 53 : IP protocol choice and collector address |
|---|
| 86 | |
|---|
| 87 | *REQUIRED* In this release the client tool host MUST be have a |
|---|
| 88 | reverse DNS for his name. If not the collector will not be able to |
|---|
| 89 | communicate with the client. Explication: filters are registered on the |
|---|
| 90 | collector in a file (rules.txt) in such way: |
|---|
| 91 | N 53.renater.fr |
|---|
| 92 | O socket 53.renater.fr 2222 |
|---|
| 93 | C 60 = 6 |
|---|
| 94 | |
|---|
| 95 | For your first action from the client to the collector it's possible to have a |
|---|
| 96 | delay before the first flow view (>20s, it depends on the delay between two |
|---|
| 97 | routers template definition) |
|---|
| 98 | |
|---|
| 99 | The client tool can be used on the collector box or in remote mode. You can |
|---|
| 100 | used few clients instantiations (on differents remotes computers). |
|---|
