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