Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The WAS mainly consists of two software components: (1) the WiFiMon Agent and (2) the WiFiMon GUI.

(1) WiFiMon Agent

The WiFiMon Agent is responsible for performing the following actions: 

  • The analysis of crowdsourced measurements. These measurements are received from End Users and  WAS correlates them with information received from RADIUS and DHCP Logs when/if this information is available.
  • The analysis of deterministic measurements. These measurements are received from WiFiMon Hardware Probes and  WAS correlates them with information received from RADIUS and DHCP Logs when/if this information is available.
  • The analysis of wireless of wireless network performance metrics received from WiFiMon Hardware Probes.
  • The analysis of TWAMP measurement results received from WiFiMon Hardware Probes.
  • Storing the results of analysis and correlation.

WiFiMon Agent operates over HTTPS, i.e. measurements are streamed over HTTPS.

(2) WiFiMon GUI

The WiFiMon GUI provides a graphical representation of the measurement results and various analyses as described above.

WAS Installation and Configuration Guide

WiFiMon can be installed using an Ansible Playbook that is available from here along with details on how to configure WiFiMon parameters. The following section provides information on how to set configuration parameters in templates/secure-processor.properties.j2 and templates/ui.properties.j2

Be aware to use the following values in the variables configuration file of Ansible Playbook: (1) ELK stack version 7.17, (2) PostgreSQL version 14 and (3) WiFiMon agent version 1.56.10. The WiFiMon deb package is available from http://83.97.95.167/deb/wifimon-agent-1.56.10.deb.

1. WiFiMon Properties 

In secure-processor.properties.j2 template file, the WiFiMon Administrator may select whether to use or not a JSON exporter. This exports measurements of hardware probes towards a JSON collector. It is designed for the eduroam JSON collector, but it could be adapted to the needs of the WiFiMon user. If you want to disable this process, property "json.collect" should be set to "false", otherwise to "true". The URL of the JSON collector should be specified at the property "json.collector".

...

Code Block
cp agent/wifimon-assembly/target/wifimon-agent-bin/secure-processor-1.56.10.war /usr/lib/wifimon/secure-processor-1.56.10.war
cp agent/wifimon-assembly/target/wifimon-agent-bin/ui-1.56.10.war /usr/lib/wifimon/ui-1.56.10.war

Finally, WiFiMon can be started by using the start.sh script within /usr/lib/wifimon:

Anchor
links
links
3. The WiFiMon GUI

Details on accessing the WiFiMon GUI are available from here.


Image RemovedImage Added

Figure 1: WiFiMon login page

...

  • Overview: Overview of the measurements for the current day, automatically updated every 30 seconds

  • Measurements: Measurements for the current day, automatically updated every 30 seconds

  • SubnetsCrowdsourced: This tab includes performance measurements for WiFiMon End Users (not WiFiMon Hardware Probes) in the monitored Subnets. By default, the measurements of all WiFiMon End Users are depicted regardless of the Subnet they reside. Visualizing measurements for a specific Subnet requires adding a Kibana filter (along with the existing one) from the "Add filter" option on top. For the example subnet a.b.c.d/xx, the Kibana filter is "requesterSubnet is a.b.c.d/xx".

  • HWProbes: This tab includes measurements from the monitored WiFiMon Hardware Probes (not WiFiMon End Users) in the monitored Subnets. By default, the measurements of all WiFiMon Hardware Probes are depicted. Visualizing measurements for a specific WiFiMon Hardware Probe requires adding a Kibana filter (along with the existing one) from the "Add filter" option on top. Each WiFiMon Hardware Probe is assigned a number. For the measurements of the WiFiMon Hardware Probe assigned the number "1", the required Kibana filter is "probeNo is 1". Assigning a number in each WiFiMon Hardware Probe is possible via the "testtool" attribute of the WiFiMon monitored test pages. More information is available in the WiFiMon Test Server installation guide.

  • TWAMP: This dashboard includes measurements obtained using TWAMP among the WiFiMon Hardware Probes and the WiFiMon Test Server.
  • Statistics:

    • Pie Statistics for current day, automatically updated every 30 seconds

    • Table Statistics for current day, automatically updated every 30 seconds

...

As a first step you should add the Subnet of your WiFi network to allow measurements.


Image RemovedImage Added 

Figure 2: Overview tab of WiFiMon GUI


Image Removed Image Added

Figure 3: Subnets tab of WiFiMon GUIHWProbes tab (Performance metrics)


Image AddedImage Removed

Figure 4: HWProbes TWAMP tab (Performance metrics)