Before following the steps below, ensure you have already executed installation tutorial.
The tool is based on InfluxDB. You've already created a docker container instance for it. Therefore, you should access the client through your browser. Then, type the following link in the URL bar:
http://localhost:8086
After that you'll encounter the following page:
Get started and create new credentials to your database. You can choose username, password and Initial Bucket Name, but the Initial Organization Name must be MM-Int like in the image below:
Copy the TOKEN in the next page and paste into .env.examle. You also have to rename this file to .env.
Click on Configure Later and lets create new buckets
Here you should create 4 buckets, each one will store data from each edge switch in the topology. You must name them as e1, e2, e3 and e4.
If you don't create these buckets, the dashboard templates will not work
Now you should import dashboard templates to your system
https://github.com/vortex2jm/MM-INT/blob/main/util/templates/s3e%40route_sep.json
https://github.com/vortex2jm/MM-INT/blob/main/util/templates/s3e2sw_sep.json
https://github.com/vortex2jm/MM-INT/blob/main/util/templates/s3e2pq_sep.json
copy the links above and follow the steps below:
- Go to the dashboards tab
- Click on CREATE DASHBOARD and Add Template
- Paste the link in the field and click on LOOK UP TEMPLATE
- Then, INSTALL TEMPLATE (One link each time)
Backing to the dashboards page, the template will be there, like in the image below:
Select the dashboard. Then, you can setup the autorefresh to see the data updating in real time:
Now you're ready, but the database have no data yet. In this way, you'll setup the topology.
In the root directory execute the following command:
sudo python3 main.py -s 3or
sudo python3 main.py -s 1The flag -s selects the solution. If you don't know about the
solutions, you can read the article with details.
If you've done everything correctly so far, the Mininet CLI should be open.
The following topology is running:
You can test it sending a PING packet from h1 to h2:
h1 ping h2 -c 1
The expect result is:
Now you can simulate traffic and INT probes
TRAFFIC
Supose that you wanna send traffic from h1 to h2:
- Open h1 and h2 terminals
xterm h1 h2
- Into h2 terminal type the following command to create a server to receive packets:
sudo iperf -s -u
- Into h1 terminal type:
sudo iperf -c 10.0.1.2 -i 1 -t 300 -u -b 10M
In the command above, you've created a packet sender with 10Mbps band.
In this way, you have traffic circulating in your network, but it is not visible. If you wanna see the packets getting to the destiny, open another terminal in h2 and type:
xterm h2
- and after:
sudo tcpdump -i eth1
INT PROBES
Now you can send and collect INT probes on the topology and visualize the collected data:
- Open a terminal in e2:
xterm e2
- Navigate to the packet-tools path:
cd util/packet-tools/
- Here you'll activate the probes receiver:
sudo python3 receive_probes.py -s 3 -i e2-eth1 -db e2
Note that -s is the flag for solution you've chose (1 or 3), -i is the interface connected to the core switch
and -db is the name of bucket created in your database (in my case, e1, e2, e3, and e4).
If you wanna create log files, use the -f flag accompanied by the name of file you want.
- Open a terminal in h1:
xterm h1
- Navigate to the path of packet-tools:
cd util/packet-tools/
- Now you're ready to send probes:
sudo python3 send_probes.py 10.0.1.2
In the command above, you'll send probes to h2, but the behavior of probes will change depending
on the solution you have chose (1 or 3). Read the article for more information.
Getting back to the InfluxDB, open your browser again and go to the dashboards page to visualize the data.
This software has a lot of features to explore. You can find more on InfluxDB.
This is the system schematic
